Skip to main content
POST
Returns a US public company’s registry record and most recent filings from the US Securities and Exchange Commission, by its Central Index Key (CIK): name, entity type, industry, tickers and addresses, then each filing’s form, dates and document link, newest first. It looks up by identifier only, not by company name or ticker, and does not return officers.

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
Only filings of this exact form type, for example 10-K. 1 to 20 characters.
string
Only filings made on or after this date. Use YYYY-MM-DD.
string
Only filings made on or before this date. Use YYYY-MM-DD.
integer
Most filings to return, newest first. From 1 to 50. Defaults to 10.

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_filings
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
When the source says the fact was last updated, or null when the source gives no date

Result

Nested under data.result.
boolean
False when the identifier is not in the register; every other field is then empty.
string | null
The identifier, padded to 10 digits. null when the source gives no value.
string | null
Name. null when the source gives no value.
string | null
Entity type. null when the source gives no value.
string | null
Standard Industrial Classification (SIC) code. null when the source gives no value.
string | null
Industry. null when the source gives no value.
string[]
Tickers.
string[]
Exchanges.
string | null
State of incorporation. null when the source gives no value.
string | null
MMDD. null when the source gives no value.
string | null
Website. null when the source gives no value.
string | null
Phone. null when the source gives no value.
string[]
Former names.
string | null
Street. null when the source gives no value.
string | null
City. null when the source gives no value.
string | null
State. null when the source gives no value.
string | null
Postal code. null when the source gives no value.
object[]
Newest first.
string
Form type, for example 10-K, 10-Q, 8-K, 4.
string | null
Date the filing was made, YYYY-MM-DD. null when the source gives no value.
string | null
Period the filing reports on, YYYY-MM-DD, when it has one. null when the source gives no value.
string | null
Description. null when the source gives no value.
string
The filing identifier, with dashes.
string | null
Link to the primary document. 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 identifier the US Securities and Exchange Commission assigns to every filer.
  • The registry record gives the legal name, entity type, industry, tickers, exchanges, state of incorporation, fiscal year end, website, phone, former names and business address. Each filing gives its form type, filing date, reporting period and a link to the document.
  • Narrow the filings with form (exact form type, for example 10-K), filed_after and filed_before.
  • Filters apply to the most recent filings the register lists inline (about 1,000), not the full history.
  • found is false when the identifier is not in the register.
  • Results return inline. The finished job stays available at /v1/requests/{request_id}