curl -X POST https://win.oneshotagent.com/v1/tools/lookup/company-filings \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"cik": "320193",
"form": "8-K",
"limit": 1
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/company-filings", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"cik": "320193",
"form": "8-K",
"limit": 1
}),
});
const result = await agent.tool('lookup/company-filings', {
cik: '320193',
form: '8-K',
limit: 1
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "company_filings",
"result": {
"found": true,
"cik": "0000320193",
"name": "Apple Inc.",
"entity_type": "operating",
"industry_code": "3571",
"industry": "Electronic Computers",
"tickers": [
"AAPL"
],
"exchanges": [
"Nasdaq"
],
"state_of_incorporation": "CA",
"fiscal_year_end": "0926",
"website": null,
"phone": "(408) 996-1010",
"former_names": [
"APPLE INC",
"APPLE COMPUTER INC",
"APPLE COMPUTER INC/ FA"
],
"street": "ONE APPLE PARK WAY",
"city": "CUPERTINO",
"state": "CA",
"postal_code": "95014",
"filings": [
{
"form": "8-K",
"filed_on": "2026-07-30",
"period_end": "2026-07-30",
"description": "8-K",
"accession_number": "0000320193-26-000018",
"url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000018/aapl-20260730.htm"
}
]
},
"evidence": {
"source": "US Securities and Exchange Commission",
"source_kind": "public",
"retrieved_at": "2026-01-15T12:00:00.000Z",
"as_of": null
}
}
}
Lookups
Company Filings
Look up a US public company’s registry record and recent filings by its registry identifier.
POST
/
v1
/
tools
/
lookup
/
company-filings
curl -X POST https://win.oneshotagent.com/v1/tools/lookup/company-filings \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"cik": "320193",
"form": "8-K",
"limit": 1
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/company-filings", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"cik": "320193",
"form": "8-K",
"limit": 1
}),
});
const result = await agent.tool('lookup/company-filings', {
cik: '320193',
form: '8-K',
limit: 1
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "company_filings",
"result": {
"found": true,
"cik": "0000320193",
"name": "Apple Inc.",
"entity_type": "operating",
"industry_code": "3571",
"industry": "Electronic Computers",
"tickers": [
"AAPL"
],
"exchanges": [
"Nasdaq"
],
"state_of_incorporation": "CA",
"fiscal_year_end": "0926",
"website": null,
"phone": "(408) 996-1010",
"former_names": [
"APPLE INC",
"APPLE COMPUTER INC",
"APPLE COMPUTER INC/ FA"
],
"street": "ONE APPLE PARK WAY",
"city": "CUPERTINO",
"state": "CA",
"postal_code": "95014",
"filings": [
{
"form": "8-K",
"filed_on": "2026-07-30",
"period_end": "2026-07-30",
"description": "8-K",
"accession_number": "0000320193-26-000018",
"url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000018/aapl-20260730.htm"
}
]
},
"evidence": {
"source": "US Securities and Exchange Commission",
"source_kind": "public",
"retrieved_at": "2026-01-15T12:00:00.000Z",
"as_of": null
}
}
}
Look up a US public company by its Central Index Key (CIK), the identifier the US Securities and Exchange Commission assigns to every filer. Returns the registry record: legal name, entity type, industry, tickers, exchanges, state of incorporation, fiscal year end, website, phone, former names and business address; and the most recent filings, newest first, each with 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. Looks up by identifier only: it does not search by company name or ticker, and it does not return officers. 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.
Authentication
Requires x402 payment in thepayment-signature header.
Request Body
string
required
The 1 to 10 digit 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, YYYY-MM-DD. Use YYYY-MM-DD.
string
Only filings made on or before this date, YYYY-MM-DD. Use YYYY-MM-DD.
integer
Most filings to return, newest first (1 to 50, default 10). 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:
completedstring
Always
company_filingsobject
The answer, described under Result below
object
Where the answer came from and when
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 otherwisestring
When the lookup was made, as an ISO 8601 UTC time
string
When the source says the fact was last updated, or
null when the source gives no dateResult
Nested underdata.result.
boolean
False when the identifier is not in the register; every other field is then empty.
string
The identifier, padded to 10 digits.
null when the source gives no value.string
Name.
null when the source gives no value.string
Entity type.
null when the source gives no value.string
Standard Industrial Classification (SIC) code.
null when the source gives no value.string
Industry.
null when the source gives no value.string[]
Tickers.
string[]
Exchanges.
string
State of incorporation.
null when the source gives no value.string
MMDD.
null when the source gives no value.string
Website.
null when the source gives no value.string
Phone.
null when the source gives no value.string[]
Former names.
string
Street.
null when the source gives no value.string
City.
null when the source gives no value.string
State.
null when the source gives no value.string
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
Date the filing was made, YYYY-MM-DD.
null when the source gives no value.string
Period the filing reports on, YYYY-MM-DD, when it has one.
null when the source gives no value.string
Description.
null when the source gives no value.string
The filing identifier, with dashes.
string
Link to the primary document.
null when the source gives no value.curl -X POST https://win.oneshotagent.com/v1/tools/lookup/company-filings \
-H "Content-Type: application/json" \
-H "payment-signature: <base64 x402 payment>" \
-d '{
"cik": "320193",
"form": "8-K",
"limit": 1
}'
const response = await fetch("https://win.oneshotagent.com/v1/tools/lookup/company-filings", {
method: "POST",
headers: {
"Content-Type": "application/json",
"payment-signature": paymentProof,
},
body: JSON.stringify({
"cik": "320193",
"form": "8-K",
"limit": 1
}),
});
const result = await agent.tool('lookup/company-filings', {
cik: '320193',
form: '8-K',
limit: 1
});
console.log(result.data.result);
console.log(result.data.evidence);
{
"success": true,
"data": {
"request_id": "uuid",
"receipt_id": "rcpt_...",
"status": "completed",
"tool": "company_filings",
"result": {
"found": true,
"cik": "0000320193",
"name": "Apple Inc.",
"entity_type": "operating",
"industry_code": "3571",
"industry": "Electronic Computers",
"tickers": [
"AAPL"
],
"exchanges": [
"Nasdaq"
],
"state_of_incorporation": "CA",
"fiscal_year_end": "0926",
"website": null,
"phone": "(408) 996-1010",
"former_names": [
"APPLE INC",
"APPLE COMPUTER INC",
"APPLE COMPUTER INC/ FA"
],
"street": "ONE APPLE PARK WAY",
"city": "CUPERTINO",
"state": "CA",
"postal_code": "95014",
"filings": [
{
"form": "8-K",
"filed_on": "2026-07-30",
"period_end": "2026-07-30",
"description": "8-K",
"accession_number": "0000320193-26-000018",
"url": "https://www.sec.gov/Archives/edgar/data/320193/000032019326000018/aapl-20260730.htm"
}
]
},
"evidence": {
"source": "US Securities and Exchange Commission",
"source_kind": "public",
"retrieved_at": "2026-01-15T12:00:00.000Z",
"as_of": null
}
}
}
Price: $0.01 per lookup. See Pricing for every tool.
Notes
- Results return inline. The finished job stays available at
/v1/requests/{request_id}