{"openapi":"3.1.0","info":{"title":"US Company Financials & Fundamentals API","version":"1.0.0","description":"Live fundamental financials for US public companies straight from the SEC's official XBRL data — no key, nothing stored. The \"what does the balance sheet and income statement say\" view of a company: the actual reported revenue, earnings, assets and equity pulled from its SEC filings, distinct from the quote, analyst, insider and SEC-filings (EDGAR) APIs in the catalogue. The financials endpoint returns the latest annual key figures: revenue, gross profit, operating income, net income, total assets, total liabilities, shareholders' equity, cash, diluted EPS and the computed net margin. The concept endpoint returns the multi-year time series for a single metric — revenue history, net-income history and more — so you can chart how a company has grown. The company endpoint resolves a ticker to its SEC company (CIK and legal name). Build stock-screeners, valuation models, fundamentals dashboards and research tools on top of authoritative SEC data. Look up any US public company by its ticker; figures are the latest annual (10-K) values reported to the SEC in USD.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/financials-api","description":"oanor gateway"}],"tags":[{"name":"Financials"},{"name":"Concept"},{"name":"Company"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/financials":{"get":{"operationId":"get_v1_financials","tags":["Financials"],"summary":"Latest annual key financials for a company","description":"","parameters":[{"name":"ticker","in":"query","required":true,"description":"Stock ticker","schema":{"type":"string"},"example":"AAPL"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"cik":320193,"cash":35934000000,"source":"SEC EDGAR (XBRL)","ticker":"AAPL","company":"Apple Inc.","revenue":416161000000,"currency":"USD","net_income":112010000000,"eps_diluted":7.46,"gross_profit":195201000000,"total_assets":359241000000,"net_margin_pct":26.92,"operating_income":133050000000,"fiscal_period_end":"2025-09-27","total_liabilities":285508000000,"shareholders_equity":73733000000},"meta":{"timestamp":"2026-06-12T01:42:23.258Z","request_id":"f05d7d40-e734-406f-a3c5-3dfa03e7816f"},"status":"ok","message":"Financials retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/concept":{"get":{"operationId":"get_v1_concept","tags":["Concept"],"summary":"Multi-year time series for one metric","description":"","parameters":[{"name":"ticker","in":"query","required":true,"description":"Stock ticker","schema":{"type":"string"},"example":"AAPL"},{"name":"metric","in":"query","required":false,"description":"revenue, net_income, assets, equity, eps_diluted… (default revenue)","schema":{"type":"string"},"example":"revenue"},{"name":"limit","in":"query","required":false,"description":"Years (default 10, max 30)","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"unit":"USD","count":10,"label":"Revenue from Contract with Customer, Excluding Assessed Tax","metric":"revenue","series":[{"value":260174000000,"period_end":"2019-09-28","fiscal_year":2021},{"value":91819000000,"period_end":"2019-12-28","fiscal_year":2020},{"value":58313000000,"period_end":"2020-03-28","fiscal_year":2020},{"value":59685000000,"period_end":"2020-06-27","fiscal_year":2020},{"value":274515000000,"period_end":"2020-09-26","fiscal_year":2022},{"value":365817000000,"period_end":"2021-09-25","fiscal_year":2023},{"value":394328000000,"period_end":"2022-09-24","fiscal_year":2024},{"value":383285000000,"period_end":"2023-09-30","fiscal_year":2025},{"value":391035000000,"period_end":"2024-09-28","fiscal_year":2025},{"value":416161000000,"period_end":"2025-09-27","fiscal_year":2025}],"source":"SEC EDGAR (XBRL)","ticker":"AAPL","company":"Apple Inc.","concept":"RevenueFromContractWithCustomerExcludingAssessedTax"},"meta":{"timestamp":"2026-06-12T01:42:23.349Z","request_id":"4b7b6ba4-ffbd-4669-9443-d253a818a8f4"},"status":"ok","message":"Concept retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/company":{"get":{"operationId":"get_v1_company","tags":["Company"],"summary":"Resolve a ticker to its SEC company","description":"","parameters":[{"name":"ticker","in":"query","required":true,"description":"Stock ticker","schema":{"type":"string"},"example":"AAPL"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"cik":320193,"source":"SEC EDGAR","ticker":"AAPL","company":"Apple Inc.","cik_padded":"CIK0000320193"},"meta":{"timestamp":"2026-06-12T01:42:23.428Z","request_id":"740e5dd0-a605-4ad6-a9ed-05fbb5f22452"},"status":"ok","message":"Company retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service metadata","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Look up a company by its ticker (ticker=AAPL). Figures are the latest annual (10-K) values reported to the SEC in USD. The concept endpoint accepts metric=revenue|gross_profit|operating_income|net_income|assets|liabilities|equity|cash|eps_diluted.","source":"SEC EDGAR XBRL company-facts API (data.sec.gov, live)","service":"financials-api","endpoints":{"GET /v1/meta":"This document.","GET /v1/company":"Resolve a ticker to its SEC company (CIK, legal name).","GET /v1/concept":"Multi-year time series for one metric (ticker=AAPL, metric=revenue).","GET /v1/financials":"Latest annual key financials for a company (ticker=AAPL)."},"description":"Live fundamental financials for US public companies from the SEC's official XBRL data. financials = the latest annual key figures (revenue, gross profit, operating income, net income, total assets, total liabilities, shareholders' equity, cash, diluted EPS, net margin); concept = the multi-year time series for a single metric; company = resolves a ticker to its SEC company (CIK and legal name). Live, no key, nothing stored. Straight from a company's SEC filings — distinct from the quote, analyst, insider and SEC-filings (EDGAR) APIs.","tickers_indexed":10416,"upstream_status":"ok"},"meta":{"timestamp":"2026-06-12T01:42:23.514Z","request_id":"e82cf0b6-a959-4bdf-9739-3d54e0aac6f8"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":12800,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":860,"monthly_call_quota":195000,"rps_limit":10,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2520,"monthly_call_quota":805000,"rps_limit":28,"hard_limit":true},{"slug":"scale","name":"Scale","price_cents_month":5740,"monthly_call_quota":2900000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/financials-api"}