{"uid":"cap_YklBywbv1RpnitYL0CuJe","slug":"mekler-ai-annual-sec-financial-facts-6979510c","name":"Mekler AI Annual SEC Financial Facts","description":"Dated topic news search, x402 service diagnostics, annual SEC financial facts, CSV validation, citation-source comparison, web extraction and email domain checks for agents. Find recent topic news with deduplicated source links and optional source-linked headline highlights; retrieve six annual US-GAAP USD fields by CIK with filing links, same-filing growth checks and optional observed revisions; check supplied CSV and citations; extract public page text, rendering JavaScript in a headless browser when needed; inspect email address syntax and mail-domain DNS. Pay per call with native USDC on Base or Solana via x402, without a separate API key. Wallet-first free trials cover CSV, column-spec, citation and static-page operations.","url":"https://api.mekler.ai/v1/finance/companies/retrieve-annual-facts?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"cik":{"type":"string","pattern":"^[0-9]{1,10}$"},"years":{"type":"integer","default":3,"maximum":3,"minimum":1},"snapshot":{"type":"string","maxLength":65536,"minLength":1},"quote_mode":{"enum":["fast"],"type":"string"},"include_revisions":{"type":"boolean","default":false}}},"responseSchema":{"type":"json","example":{"cik":"0000320193","years":[{"fields":{"cash":{"value":35934000000,"status":"reported"},"assets":{"tag":"Assets","form":"10-K","unit":"USD","filed":"2025-10-31","value":359241000000,"status":"reported","taxonomy":"us-gaap","accession":"0000320193-25-000079","period_end":"2025-09-27","period_start":null},"revenue":{"value":416161000000,"status":"reported"},"net_income":{"value":112010000000,"status":"reported"},"liabilities":{"value":285508000000,"status":"reported"},"operating_cash_flow":{"value":111482000000,"status":"reported"}},"period_end":"2025-09-27","fiscal_year":2025}],"status":"ok","sources":{"submissions":"https://data.sec.gov/submissions/CIK0000320193.json","companyfacts":"https://data.sec.gov/api/xbrl/companyfacts/CIK0000320193.json"},"coverage":{"complete":true,"returned_years":1,"reported_fields":6,"requested_years":1,"requested_fields":6},"comparisons":[],"limitations":["US-GAAP standard whole-entity USD facts in annual 10-K/10-K/A only."],"retrieved_at":"2026-10-05T00:00:00Z","selection_policy":"latest-annual-filed-per-field-v1"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oMrTIHWABZ1q9yoHBMO4D","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves up to three years of annual US-GAAP financial facts (assets, liabilities, revenue, net income, cash, operating cash flow) for a US public company by CIK, with filing links and growth checks.","exampleAgentPrompt":"Pull the last 3 years of annual SEC financial facts — assets, liabilities, revenue, net income, cash, and operating cash flow — for the company with CIK 0000320193, and include filing links.","exampleUseCases":[{"title":"Annual financials for equity research","prompt":"Get me the last 3 years of annual US-GAAP financials from SEC 10-K filings for Apple — CIK 0000320193 — including assets, revenue, net income, and the direct filing links."},{"title":"Year-over-year revenue growth check","prompt":"Retrieve two years of annual SEC facts for Tesla (CIK 0001318605) so I can compare revenue and operating cash flow growth between the two most recent fiscal years."},{"title":"Validate cited financials against SEC source","prompt":"I have a report claiming company CIK 0000051143 had $50 billion in assets last year — can you pull the actual annual assets figure from their latest 10-K on SEC EDGAR so I can verify the citation?"}],"resultDescription":"A JSON object containing up to three annual periods of six US-GAAP USD financial fields (assets, liabilities, revenue, net income, cash, operating cash flow), each with value, status, taxonomy tag, form type, accession number, filing URL, and period dates. Also includes coverage statistics, source URLs to SEC EDGAR submissions and company facts endpoints, any same-filing growth comparisons, retrieval timestamp, and selection policy used.","failureModes":["Invalid or non-existent CIK returns error or empty results","Company uses non-standard US-GAAP tags — fields returned as missing status","Company not a US public filer — no SEC data available","Years parameter out of range (must be 1-3) — validation error","Payment not completed via x402 — 402 Payment Required response","Fields missing if company did not file a 10-K for a given year","Snapshot input too large (exceeds 65,536 characters) — rejection"],"whenToPreferThis":"Choose this endpoint when you need authoritative annual US-GAAP financial facts sourced directly from SEC EDGAR 10-K filings for US public companies, with direct filing links and accession numbers for citation. Prefer it over third-party financial data APIs when regulatory-grade sourcing and filing traceability matter. It is pay-per-call with no API key required, making it ideal for agents that need occasional lookups without subscription overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:31:50.326Z","isFirstParty":false,"canonicalSlug":"mekler-ai-annual-sec-financial-facts-6979510c"}