Go from a search result to the full story.
# RESULT_ID: the id of a search result.
curl -sS "https://data.finks.ai/v1/content/$RESULT_ID" \
-H "Authorization: Bearer $FINKS_API_KEY"A search result's id. It is opaque: pass it as it came.
A search result's id. It is opaque: pass it as it came.
Filing: permanent identifier of the cited source span.
YYYY-MM-DD: the calendar row's report date, within a day of the filing.
The calendar's label: earnings_calendar_feed.
Per share, US dollars: the company's adjusted EPS where it reports one, else GAAP.
gaap or adjusted: the verified actual's basis. Verified actuals only.
An actual against its estimate: EPS to the cent, revenue within ±0.5% is inline.
eps_actual - eps_estimate, to the cent. Verified actuals only.
The surprise as a percent of |estimate|, one decimal. Verified actuals only, and absent when |estimate| < 0.10 or the actual and the estimate differ in sign.
Q1..Q4, the reported quarter as the company names it.
The reported quarter's fiscal year as the company names it.
YYYY-MM-DD: the last close before the reaction session.
reaction_close / base_close - 1 in percent, two decimals; split-adjusted closes.
YYYY-MM-DD: the reaction session's date.
The session that priced the news first: pre (before the open on the reaction date), intraday, or after (the reaction is a later trading day). The price_* fields are all present or all absent.
Total revenue, US dollars.
An actual against its estimate: EPS to the cent, revenue within ±0.5% is inline.
As eps_surprise_pct.
Filing: the event's type, one of the event-type allowlist's slugs (earnings, insider_transaction for a Form 4, insider_sale_notice for a Form 144, beneficial_ownership for a Schedule 13D/13G, periodic_report, ...). Absent on other types and when the filing's type is not on the allowlist.
Filing: verbatim text from the source document.
Filing, beside excerpt only: the excerpt passage's citation id.
Filing, beside excerpt only: lower-hex SHA-256 of excerpt exactly as served (its UTF-8 bytes, no normalization).
Filing, beside excerpt only: the excerpt passage's document URL.
The reporting owner, as filed (Parekh Kevan).
SEC transaction codes, as filed (P open-market purchase, S open-market sale, A grant or award, M option exercise, F tax withholding, G gift, …).
How many transactions the filing lists for that day and direction.
YYYY-MM-DD.
acquired or disposed.
US dollars per share, the value-weighted average. Absent when not filed (an award).
US dollars, summed. Absent when not filed.
Whether the filing marks its transactions as made under a Rule 10b5-1 plan. Absent when the filing does not say.
Filing: the event ledger id (le1:) of the real-world event this filing proves, shared by an 8-K and its 8-K/As. Absent when the ledger holds no row for it. On a company-timeline brief or article: the event of the 8-K folded into it.
Deep search: which half ranked a result.
Deep search: the passage of a result that best matches the query: a brief's or article's body, or one of a filing's sections.
CommonMark. Brief, article: Finks-written, never a publisher's words. Filing: verbatim filing text.
Unicode code-point offset, exclusive. Absent with start.
Filing only: the section the passage is from, one of the sections[].section_id GET /v1/content/{id} serves.
Unicode code-point offset, inclusive, into the text GET /v1/content/{id} serves: a brief's or article's body, a filing's text of section section_id, a transcript's body. Absent when the offsets could not be verified against text.
Brief, article: publisher domains behind the text.
The document type: press_release, litigation_release, administrative_proceeding, enforcement_action, corporate_decision, conditional_approval, interpretive_letter, crs_report. Open vocabulary.
Transcript: what url links to, e.g. sec_8k (the SEC EDGAR index page of the earnings-release 8-K the call discusses), never a transcript page. Other values may appear: treat an unknown one as another kind of source link. Absent without a url.
Brief: the key facts as a CommonMark bullet list, each ending with its outlets, then the context sentence; the stored source-link list is never served. Article: the full article text. Transcript: the call's transcript, verbatim; absent until its text lands or where its rights are not allow.
Filing: the form as filed: 8-K, 8-K/A, 6-K, 6-K/A, a periodic report form (10-K, 10-K/A, 10-KT, 10-Q, 10-Q/A, 10-QT, 20-F, 20-F/A, 40-F, 40-F/A), an offering or proxy form (S-1, S-1/A, F-1, F-1/A, 424B4, 424B1, DEF 14A), or another SEC form (144, 3, 4, 5, NT 10-K, 25-NSE, 15-12G, 13F-HR, SCHEDULE 13D, SCHEDULE 13G, ..., and their /As).
Filing: the 8-K item (2.02). Absent on a 6-K, a periodic report, an offering or proxy filing or another SEC form.
The section's title (Item 2.02, Results of Operations and Financial Condition); an offering or proxy filing's section heading as filed (USE OF PROCEEDS).
Lower-hex SHA-256 of text exactly as served (UTF-8, no normalization); absent with text.
Filing: the verbatim filing quotes behind each sentence of summary. Absent when no sentence has one.
The section is an exhibit (EX-99.x), not an item body.
Verbatim filing text: the filer's own words.
The section quoted: an item body or an exhibit, as sections[].section_id on GET /v1/content/{id}.
Unicode code-point offset, exclusive. Absent with passage_start.
Unicode code-point offset, inclusive, into that section's text on GET /v1/content/{id}: the start of the passage that contains the quote, not of the quote itself. Absent on GET /v1/content, which serves no section text, and wherever the served text does not hold the quote at these offsets.
The sentence, verbatim as it appears in the record's summary.
request.invalid, not an id this API serves; request.out_of_plan naming type, the plan does not cover the id's poolwithdrawn, no servable record carries this idcontent.unresolved, the read did not resolve# LEDGER_EVENT_ID: a filing result's ledger_event_id.
curl -sS "https://data.finks.ai/v1/events/$LEDGER_EVENT_ID" \
-H "Authorization: Bearer $FINKS_API_KEY"A filing's ledger_event_id, from a search result or the filing feed.
Every filing event (e1:) that proves this event, oldest first: the 8-K, then each 8-K/A (a Form 4, then each 4/A; a 13F, then its amendments).
The filing event (e1:) whose facts are current: the newest anchor.
EDGAR acceptance of the first anchor filing, RFC 3339.
EDGAR acceptance of the newest anchor filing, RFC 3339.
A filing's ledger_event_id, from a search result or the filing feed.
Whom a ledger event happened to: the 8-K filer, a Form 4's or 13D/13G's issuer, a 13F's filer.
The 8-K item (2.02); a Form 4's transaction code (S, P, ...), a 13F's report kind (report, restatement, new_holdings), a 13D/13G's activist or passive.
YYYY-MM-DD: the 8-K's date of the earliest event reported; a Form 4's transaction date, a 13F's period end, a 13D/13G's date of the event requiring the filing.
request.invalid, not a ledger id; request.out_of_plan, the plan does not cover filingnot_found, the ledger serves no event under this idcontent.unresolved, the ledger or the filing read did not resolvefilingtranscriptregulatorFiling: permanent identifier of the cited source span.
YYYY-MM-DD: the calendar row's report date, within a day of the filing.
The calendar's label: earnings_calendar_feed.
Per share, US dollars: the company's adjusted EPS where it reports one, else GAAP.
gaap or adjusted: the verified actual's basis. Verified actuals only.
An actual against its estimate: EPS to the cent, revenue within ±0.5% is inline.
eps_actual - eps_estimate, to the cent. Verified actuals only.
The surprise as a percent of |estimate|, one decimal. Verified actuals only, and absent when |estimate| < 0.10 or the actual and the estimate differ in sign.
Q1..Q4, the reported quarter as the company names it.
The reported quarter's fiscal year as the company names it.
YYYY-MM-DD: the last close before the reaction session.
reaction_close / base_close - 1 in percent, two decimals; split-adjusted closes.
YYYY-MM-DD: the reaction session's date.
The session that priced the news first: pre (before the open on the reaction date), intraday, or after (the reaction is a later trading day). The price_* fields are all present or all absent.
Total revenue, US dollars.
An actual against its estimate: EPS to the cent, revenue within ±0.5% is inline.
As eps_surprise_pct.
Filing: the event's type, one of the event-type allowlist's slugs (earnings, insider_transaction for a Form 4, insider_sale_notice for a Form 144, beneficial_ownership for a Schedule 13D/13G, periodic_report, ...). Absent on other types and when the filing's type is not on the allowlist.
Filing: verbatim text from the source document.
Filing, beside excerpt only: the excerpt passage's citation id.
Filing, beside excerpt only: lower-hex SHA-256 of excerpt exactly as served (its UTF-8 bytes, no normalization).
Filing, beside excerpt only: the excerpt passage's document URL.
The reporting owner, as filed (Parekh Kevan).
Whether the filing marks its transactions as made under a Rule 10b5-1 plan. Absent when the filing does not say.
A filing's ledger_event_id, from a search result or the filing feed.
Deep search: which half ranked a result.
Deep search: the passage of a result that best matches the query: a brief's or article's body, or one of a filing's sections.
CommonMark. Brief, article: Finks-written, never a publisher's words. Filing: verbatim filing text.
Unicode code-point offset, exclusive. Absent with start.
Filing only: the section the passage is from, one of the sections[].section_id GET /v1/content/{id} serves.
Unicode code-point offset, inclusive, into the text GET /v1/content/{id} serves: a brief's or article's body, a filing's text of section section_id, a transcript's body. Absent when the offsets could not be verified against text.
Brief, article: publisher domains behind the text.
The document type: press_release, litigation_release, administrative_proceeding, enforcement_action, corporate_decision, conditional_approval, interpretive_letter, crs_report. Open vocabulary.
Transcript: what url links to, e.g. sec_8k (the SEC EDGAR index page of the earnings-release 8-K the call discusses), never a transcript page. Other values may appear: treat an unknown one as another kind of source link. Absent without a url.
Brief: the key facts as a CommonMark bullet list, each ending with its outlets, then the context sentence; the stored source-link list is never served. Article: the full article text. Transcript: the call's transcript, verbatim; absent until its text lands or where its rights are not allow.
Filing: the form as filed: 8-K, 8-K/A, 6-K, 6-K/A, a periodic report form (10-K, 10-K/A, 10-KT, 10-Q, 10-Q/A, 10-QT, 20-F, 20-F/A, 40-F, 40-F/A), an offering or proxy form (S-1, S-1/A, F-1, F-1/A, 424B4, 424B1, DEF 14A), or another SEC form (144, 3, 4, 5, NT 10-K, 25-NSE, 15-12G, 13F-HR, SCHEDULE 13D, SCHEDULE 13G, ..., and their /As).
Filing: the 8-K item (2.02). Absent on a 6-K, a periodic report, an offering or proxy filing or another SEC form.
The section's title (Item 2.02, Results of Operations and Financial Condition); an offering or proxy filing's section heading as filed (USE OF PROCEEDS).
Lower-hex SHA-256 of text exactly as served (UTF-8, no normalization); absent with text.
Filing: the verbatim filing quotes behind each sentence of summary. Absent when no sentence has one.