Skip to main content
POST
Returns one reported financial figure of a US public company, by Central Index Key (CIK), from its filings with the US Securities and Exchange Commission: one value per period, newest first, with dates, fiscal period, form, filing date and accession number. Figures are as the company reported them; a later filing that restates a period replaces the earlier value.

Authentication

Requires x402 payment in the payment-signature header.

Request Body

string
required
The registry identifier (CIK), for example 320193. Shorter numbers are padded with zeros. A CIK is 1 to 10 digits.
string
required
Which reported figure to return. One of revenue, net_income, operating_income, total_assets, total_liabilities, stockholders_equity, cash, eps_diluted.
string
Fiscal years or fiscal quarters. One of annual, quarterly. Defaults to "annual".
integer
Most periods to return, newest first. From 1 to 20. Defaults to 5.

Response (200 OK)

Top-level envelope: success (boolean) and data (object). All fields below are nested under data.
string
Durable job ID for audit and lookup
string
Job status: completed
string
Always company_financials
object
The answer, described under Result below
object
Where the answer came from and when
boolean
true when the answer was served from OneShot’s store of earlier lookups (or its own copy of a public dataset), false when the source was asked for this call
string
When the record was obtained from its source, as an ISO 8601 UTC time; equals evidence.retrieved_at
string
The public body the data comes from. Always US Securities and Exchange Commission.
string
public when the data comes from a public body, commercial otherwise
string
When the lookup was made, as an ISO 8601 UTC time
string | null
The newest filing date among the returned periods; null when none were returned.

Result

Nested under data.result.
string
The identifier, padded to 10 digits.
string | null
The filer’s name as the source lists it; null when nothing was reported.
string
The metric asked for.
string
The US GAAP tag the figures came from.
string | null
The source’s label for the tag. null when the source gives no value.
string | null
USD, or USD/shares for eps_diluted. null when the source gives no value.
object[]
One value per period, newest end first; empty when the company never reported the tag.
string | null
The source’s calendar frame, for example CY2025 or CY2026Q2I; null when it framed none.
string | null
First day of the period, YYYY-MM-DD; null for a balance at a date.
string
Last day of the period or the balance date, YYYY-MM-DD.
number
The reported figure, in unit.
integer | null
The filer’s fiscal year the filing covers. null when the source gives no value.
string | null
FY, Q1, Q2 or Q3. null when the source gives no value.
string | null
The form that reported this value, for example 10-K or 10-Q. null when the source gives no value.
string | null
Date that filing was made, YYYY-MM-DD. null when the source gives no value.
string | null
Accession number of that filing, with dashes. null when the source gives no value.
See Pricing for this tool’s price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers 200.

Notes

  • The CIK is the registrant number the US Securities and Exchange Commission assigns to every filer, as for Company Filings. Looks up by identifier only: it does not search by company name or ticker.
  • metric is one of revenue, net_income, operating_income, total_assets, total_liabilities, stockholders_equity, cash or eps_diluted; period is annual (default) or quarterly.
  • Returns the company name, the US GAAP tag and unit the figures come from, and each value’s calendar frame, start and end dates, fiscal year and period.
  • Figures are not adjusted or restated by anyone else.
  • periods is empty when the company never reported the metric under its US GAAP tag.
  • History is kept per series: Changes addresses one by the padded identifier, metric and period joined with colons (0000320193:revenue:annual); a call with a non-default limit is kept as a query.
  • Results return inline. The finished job stays available at /v1/requests/{request_id}