{"openapi":"3.1.0","info":{"title":"Financials.page API","version":"1.0.0","description":"Annual and quarterly financials for SEC-reporting companies, extracted from EDGAR XBRL company facts (us-gaap and ifrs-full taxonomies, split-adjusted, in the filer's reporting currency) plus registrant profiles and recent filings. Data is ingested from SEC EDGAR by a daily refresh; responses are served from the database. The same data is available to AI agents over MCP at /api/mcp. Not investment advice."},"servers":[{"url":"https://financials.page"}],"paths":{"/api/v1/companies":{"get":{"operationId":"searchCompanies","summary":"Search companies by name or ticker","description":"Ranked search over ~8,000 SEC filers (exact ticker first, then ticker prefix, then name). Without `q`, returns the largest filers.","parameters":[{"name":"q","in":"query","required":false,"description":"Name or ticker fragment","schema":{"type":"string","minLength":1}},{"name":"limit","in":"query","required":false,"description":"Maximum results","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"Matching companies","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"companies":{"type":"array","items":{"type":"object","properties":{"cik":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"SEC Central Index Key — the permanent company id"},"ticker":{"type":"string","description":"Primary ticker symbol"},"name":{"type":"string","description":"Company name as registered with the SEC"}},"required":["cik","ticker","name"],"additionalProperties":false,"description":"A company in the directory"}}},"required":["companies"],"additionalProperties":false}}}},"400":{"description":"Invalid query parameters","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/v1/companies/{cik}":{"get":{"operationId":"getCompanyProfile","summary":"Registrant profile and recent filings","parameters":[{"name":"cik","in":"path","required":true,"description":"SEC Central Index Key — the permanent company id","schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Registrant profile","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"cik":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"ticker":{"type":"string"},"name":{"type":"string"},"sic":{"type":"string","description":"SIC industry description"},"exchange":{"type":"string"},"website":{"type":"string"},"category":{"type":"string","description":"SEC filer category"},"stateOfIncorporation":{"type":"string"},"fiscalYearEnd":{"type":"string","description":"e.g. \"Sep 26\""},"city":{"type":"string"},"state":{"type":"string"},"filings":{"type":"array","items":{"type":"object","properties":{"accession":{"type":"string","description":"EDGAR accession number (no dashes)"},"form":{"type":"string","description":"Form type, e.g. 10-K, 10-Q, 8-K, 4"},"date":{"type":"string","description":"Filing date (YYYY-MM-DD)"},"url":{"type":"string","description":"Link to the primary document on sec.gov"},"description":{"type":"string"}},"required":["accession","form","date","url","description"],"additionalProperties":false},"description":"Most recent EDGAR filings, newest first"}},"required":["cik","ticker","name","sic","exchange","website","category","stateOfIncorporation","fiscalYearEnd","city","state","filings"],"additionalProperties":false,"description":"Registrant profile from EDGAR submissions, refreshed daily"}}}},"400":{"description":"Invalid CIK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Unknown CIK, or company not yet ingested by the daily refresh","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}},"/api/v1/companies/{cik}/financials":{"get":{"operationId":"getCompanyFinancials","summary":"Annual and quarterly financial series","description":"Up to 12 fiscal years and 12 discrete quarters per metric, as reported (restatement-deduped, split-adjusted), in the filer's reporting currency. Q4 is derived as the annual figure less the three reported quarters.","parameters":[{"name":"cik","in":"path","required":true,"description":"SEC Central Index Key — the permanent company id","schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Financial series","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"cik":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"entityName":{"type":"string"},"currency":{"type":"string","description":"ISO reporting currency for money values (IFRS filers are often not USD)"},"annual":{"type":"object","propertyNames":{"type":"string","enum":["revenue","costOfRevenue","grossProfit","operatingIncome","netIncome","eps","operatingCashFlow","capex","rnd","dividendsPaid","buybacks","dividendsPerShare","sharesDiluted","assets","liabilities","equity","cash","currentAssets","currentLiabilities","longTermDebt"]},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"period":{"type":"string","description":"Period label — \"FY2024\" for annual, \"Dec ’24\" for quarterly"},"end":{"type":"string","description":"Period end date (YYYY-MM-DD)"},"value":{"type":"number","description":"Value in the reporting currency (per-share and share-count metrics excepted)"}},"required":["period","end","value"],"additionalProperties":false}},"description":"Annual series by metric, oldest first, up to 12 fiscal years, split-adjusted"},"quarterly":{"type":"object","propertyNames":{"type":"string","enum":["revenue","grossProfit","netIncome","eps"]},"additionalProperties":{"type":"array","items":{"type":"object","properties":{"period":{"type":"string","description":"Period label — \"FY2024\" for annual, \"Dec ’24\" for quarterly"},"end":{"type":"string","description":"Period end date (YYYY-MM-DD)"},"value":{"type":"number","description":"Value in the reporting currency (per-share and share-count metrics excepted)"}},"required":["period","end","value"],"additionalProperties":false}},"description":"Discrete quarterly series (Q4 derived from the annual figure), up to 12 quarters"}},"required":["cik","entityName","currency","annual","quarterly"],"additionalProperties":false,"description":"As-reported financials extracted from EDGAR XBRL company facts"}}}},"400":{"description":"Invalid CIK","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}},"404":{"description":"Unknown CIK, or company not yet ingested by the daily refresh","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"error":{"type":"string"}},"required":["error"],"additionalProperties":false}}}}}}}}}