Company and filings
Follow a company's filings and news as they land.
Loading
Loading
Follow a company's filings and news as they land.
Comma list of brief, article, filing. Default: every type the plan covers.
Comma list of event-type slugs (earnings, m_and_a, ...): only items carrying any of them. An item with no event type is excluded while it is set. Unset, the filings are the 8-Ks and the Form 4 (insider_transaction), Form 144 (insider_sale_notice) and Schedule 13D/13G (beneficial_ownership) filings; the other SEC form filings (ownership_stake, initial_holding, insider_annual_transaction, late_filing_notice, delisting_notice, registration_termination) are listed only when named here.
RFC 3339, inclusive. Default: the start of the plan's history window.
RFC 3339, exclusive.
Results per page: at least 1, at most your plan's page cap. Default 10, or the cap if lower.
The next_cursor of the previous page. Leave it out for the first page.
Newest first by published_at, at most limit items, may be empty.
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.
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).
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 serves.
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.
The company's ticker.
Every listing the timeline matched on: the symbol and the other classes of its issuer (GOOGL also matches GOOG), sorted.
Opaque keyset token for the next, older page. null on the last page.
The issuer's primary ticker in SEC's ticker map (GOOG -> GOOGL, BRK.A -> BRK-B; a retired ticker of a still-listed issuer, SQ -> XYZ). Absent when no issuer SEC's map lists is found for the symbol.
request.invalid naming the parameter, request.out_of_plan naming the allowance, or invalid_cursornot_found, no company is listed under this symbolcontent.unresolved, the company lookup or a pool could not answerA page can be short, even empty, before the end: keep paging while has_more is true.
curl -sS "https://data.finks.ai/v1/content?type=filing&form=8-K&limit=10" \
-H "Authorization: Bearer $FINKS_API_KEY"filing, the type this route lists.
ANY within, AND across filters.
Canonical entity ids.
any (default) or all. Without entities, a 400.
Accepted and ignored: it filters nothing today.
Taxonomy facet.
Matches the scalar event_type or the event_types[] array. Each slug must be on the event-type allowlist; any other is a 400.
Taxonomy facet.
RFC 3339, inclusive. Half-open interval with published_before.
RFC 3339, exclusive.
Ask for the raw primary-document text. Not every document can be served in full: read full_text_status for the outcome.
The next_cursor of the previous page. Leave it out for the first page.
Results per page: at least 1, at most your plan's page cap. Default 10, or the cap if lower.
full (default): the full record. compact: one small CompactFilingRecord per filing (no evidence, citations, facets, versions or rights fields) and a summary block; the page is a CompactContentPage. Compact takes no include_full_text=true.
asc (default): oldest first. desc: newest first. The cursor binds the order.
accession, with view=compact only: filings sharing an accession on the page collapse into the first one's entry, the rest under its parts.
ContentPage, or a CompactContentPage under view=compactrequest.invalid, invalid_cursor, or request.out_of_plan naming filingcontent.unresolved, the read did not resolvePer 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.
Whether the filing marks its transactions as made under a Rule 10b5-1 plan. Absent when the filing does not say.
Shares the owner holds after the filing's last transaction day. Absent when not filed, or when that day holds both an acquisition and a disposition (the table keeps no order within a day).
sections[].section_idGET /v1/content/{id}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.
articlefilingtranscriptregulatorHalf-open Unicode-codepoint span into the cited section's exact text.
CIKs, exclusive of the resolved primary, never entity_ids. Guarantor subsidiaries frequently have neither a symbol nor a minted entity_id, so a CIK is the only value guaranteed to exist for every member of the set.
Additive open vocabulary; consumers must tolerate unknown values.
filing, the type this route lists.
The complete cited set; citations[0] is citation. Absent on a pending card, where no span citation has been minted yet.
Half-open Unicode-codepoint span into the cited section's exact text.
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.
Accepted and ignored: it filters nothing today.
Raw primary-document text, when every gate permits it. See FullTextStatus for why it did or did not serve, the two fields are read together.
One-line title (finks-api#433): <Issuer>, <form> Item <n>, <item name>, or the form and item alone when the issuer is unnamed. Built from served fields; no model call.
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.
The version of payload; always absent with it.
The verbatim filing quotes behind each sentence of summary; absent when no sentence has one. Here without passage offsets: this route serves no section text.
Opaque server-issued token. null when this is the last page.