{"slug":"api-mekler-ai-v1-finance-companies-retrieve-annual-facts-100cba","title":"Annual US-GAAP facts by CIK, SEC sources, same-filing growth checks and observed","host":"api.mekler.ai","method":"POST","resource":"https://api.mekler.ai/v1/finance/companies/retrieve-annual-facts","category":"company","description":"Annual US-GAAP facts by CIK, SEC sources, same-filing growth checks and observed revisions. Fast quote or coverage preview. Free SEC data; paid selection.","price_listed":0.05,"price_asked":null,"state":"effects","state_label":"Not tested: has real-world effects","checks_7d":0,"answered_7d":0,"latency_ms_median":null,"reported_calls_30d":10,"reported_payers_30d":10,"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"cik":"320193","quote_mode":"fast","years":1},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":false,"not":{"required":["quote_mode","snapshot"]},"properties":{"cik":{"pattern":"^[0-9]{1,10}$","type":"string"},"include_revisions":{"default":false,"type":"boolean"},"quote_mode":{"enum":["fast"],"type":"string"},"snapshot":{"maxLength":65536,"minLength":1,"type":"string"},"years":{"default":3,"maximum":3,"minimum":1,"type":"integer"}},"required":["cik"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"additionalProperties":false,"properties":{"cik":{"type":"string"},"comparisons":{"items":{"type":"object"},"maxItems":12,"type":"array"},"coverage":{"additionalProperties":false,"properties":{"complete":{"type":"boolean"},"reported_fields":{"minimum":0,"type":"integer"},"requested_fields":{"minimum":0,"type":"integer"},"requested_years":{"minimum":0,"type":"integer"},"returned_years":{"minimum":0,"type":"integer"}},"required":["requested_years","returned_years","reported_fields","requested_fields","complete"],"type":"object"},"limitations":{"items":{"type":"string"},"type":"array"},"retrieved_at":{"type":"string"},"revisions":{"type":"object"},"selection_policy":{"type":"string"},"source_retrieved_at":{"additionalProperties":false,"properties":{"companyfacts":{"type":"string"},"submissions":{"type":"string"}},"type":"object"},"sources":{"additionalProperties":false,"properties":{"companyfacts":{"type":"string"},"submissions":{"type":"string"}},"required":["companyfacts","submissions"],"type":"object"},"status":{"enum":["ok"],"type":"string"},"years":{"items":{"additionalProperties":false,"properties":{"fields":{"additionalProperties":{"additionalProperties":false,"properties":{"accession":{"type":"string"},"filed":{"type":"string"},"filing_url":{"type":"string"},"form":{"enum":["10-K","10-K/A"],"type":"string"},"period_end":{"type":"string"},"period_start":{"type":["string","null"]},"reason":{"type":"string"},"status":{"enum":["reported","missing","ambiguous","unsupported"],"type":"string"},"tag":{"type":"string"},"taxonomy":{"enum":["us-gaap"],"type":"string"},"unit":{"enum":["USD"],"type":"string"},"value":{"type":["number","null"]}},"required":["status","value"],"type":"object"},"maxProperties":6,"minProperties":6,"required":["revenue","net_income","assets","liabilities","cash","operating_cash_flow"],"type":"object"},"fiscal_year":{"type":["integer","null"]},"period_end":{"type":"string"}},"required":["fiscal_year","period_end","fields"],"type":"object"},"maxItems":3,"minItems":1,"type":"array"}},"required":["status","cik","selection_policy","retrieved_at","years","coverage","sources","limitations","comparisons"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[],"description_full":"Annual US-GAAP facts by CIK, SEC sources, same-filing growth checks and observed revisions. Fast quote or coverage preview. Free SEC data; paid selection.","last_updated":"2026-10-09T00:25:04.917Z","schemes":["exact"]}