{"uid":"cap_lvAwMP4KAteLp2srMcar4","slug":"sec-financials-api-3a394b77","name":"SEC Financials API","description":"Open job postings read first-hand from the applicant-tracking system behind a company's careers page: Greenhouse, Ashby, Lever or Workable. Includes a directory of 8532 company job boards, because none of the vendors publishes one. Salaries are parsed into numbers where the employer publishes them and refused where ambiguous. No personal data.","url":"https://companyfacts.dev/x402/v1/sec-financials?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"metric":{"type":"string"},"period":{"type":"string"},"company":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"mode":"company","count":1,"metric":"net_income","company":{"cik":320193,"name":"Apple Inc."},"matched":1,"records":[{"cik":320193,"form":"10-K","unit":"USD","filed":"2024-11-01","value":93736000000,"metric":"net_income","company":"Apple Inc.","xbrl_tag":"NetIncomeLoss","accession":"0000320193-24-000123","period_end":"2024-09-28","verify_url":"https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.htm","fiscal_year":2024,"period_days":363,"period_type":"annual","period_start":"2023-10-01","fiscal_period":"FY"}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ucbxHgJT5G9FWfT9gejH6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves structured financial metrics from SEC filings (10-K, 10-Q) for public companies, returning parsed XBRL data with filing provenance.","exampleAgentPrompt":"What was Apple's net income for fiscal year 2024? Pull it directly from their SEC filing so I can see the verified source.","exampleUseCases":[{"title":"Annual earnings research for investor report","prompt":"Can you get me Microsoft's net income for fiscal year 2023 straight from their SEC 10-K filing, with a link to the original document I can verify?"},{"title":"Comparing operating metrics across filings","prompt":"What was Tesla's operating income for their most recent annual period according to SEC EDGAR? I need the exact XBRL-tagged figure."},{"title":"Due diligence financial fact-check","prompt":"Pull Amazon's total revenue from their latest annual SEC filing — I want the audited number with the accession number so I can reference the source."}],"resultDescription":"Returns a JSON object containing the matched company's CIK, the requested financial metric value (as a number), the fiscal period and dates, filing form type (e.g. 10-K), XBRL tag used, accession number, and a direct URL to the SEC filing index for verification.","failureModes":["Company not found in SEC EDGAR — returns zero matches if name is ambiguous or company is private","Metric not reported by the company in XBRL — returns empty records array","Ambiguous period specification — may return multiple records across fiscal years","Rate limiting or payment failure — 402 response if USDC payment not attached","Invalid metric name — no matching XBRL tag found in filings"],"whenToPreferThis":"Use this endpoint when you need audited, GAAP-compliant financial figures for a public US company sourced directly from SEC regulatory filings, with full provenance (accession number, verify URL). Prefer this over scraped financial data aggregators when auditability and citation to primary sources matter — e.g. for due diligence, regulatory research, or investor reporting.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:40:45.365Z","isFirstParty":false,"canonicalSlug":"sec-financials-api-3a394b77"}