{ "openapi": "3.1.0", "info": { "title": "Company Financials API", "version": "1.0.0", "description": "Annual revenue, profit, cash flow and balance sheet for 10,400 SEC filers, up to 25 years back.\n\nAnnual financial statements for every US SEC filer (~10,400 tickers), straight from their XBRL 10-K / 20-F / 40-F filings: 15 key metrics — revenue, cost of revenue, gross profit, operating income, net income, EPS, operating cash flow, capex, assets, liabilities, equity, cash, long-term debt, shares outstanding — with up to 25 years of history, restatement-aware values and correct fiscal-year labels, plus raw access to any us-gaap concept, company profiles and name search. Every figure carries its filing date and accession number. Public-domain SEC EDGAR data, cached daily.", "contact": { "name": "Data and APIs", "url": "https://dataandapis.com/contact" }, "termsOfService": "https://dataandapis.com/terms-of-service", "license": { "name": "Data and APIs Terms of Service", "url": "https://dataandapis.com/terms-of-service" }, "x-logo": { "url": "https://dataandapis.com/images/company-financials.webp" } }, "externalDocs": { "description": "Documentation, live tester and pricing", "url": "https://dataandapis.com/apis/company-financials" }, "servers": [ { "url": "https://api-company-financials.dataandapis.com" } ], "tags": [ { "name": "Finance", "description": "Company Financials API belongs to the Finance category of the Data and APIs catalog." } ], "paths": { "/v1/company/{ticker}": { "get": { "operationId": "companyProfile", "summary": "Company Profile", "description": "Company Profile endpoint of the Company Financials API. Costs 10 tokens per call.", "externalDocs": { "url": "https://dataandapis.com/apis/company-financials/company-profile" }, "parameters": [ { "name": "ticker", "in": "path", "required": true, "schema": { "type": "string" }, "example": "AAPL" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "ticker": "AAPL", "cik": "0000320193", "name": "Apple Inc.", "sic": "3571", "industry": "Electronic Computers", "exchanges": [ "Nasdaq" ], "tickers": [ "AAPL" ], "state_of_incorporation": "CA", "fiscal_year_end": "0926", "entity_type": "operating", "website": null, "latest_annual_filing": { "form": "10-K", "filed": "2025-10-31", "accession": "0000320193-25-000079", "report_date": "2025-09-27" }, "source": "SEC EDGAR XBRL companyfacts (US public-domain filings)", "source_url": "https://www.sec.gov/search-filings/edgar-application-programming-interfaces", "coverage": "US-listed SEC filers; annual (10-K / 20-F / 40-F) values only" } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/search": { "get": { "operationId": "companySearch", "summary": "Company Search", "description": "Company Search endpoint of the Company Financials API. Costs 10 tokens per call.", "externalDocs": { "url": "https://dataandapis.com/apis/company-financials/company-search" }, "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "string" }, "example": "3" }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string" }, "example": "berkshire" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "query": "berkshire", "count": 2, "results": [ { "ticker": "BRK-B", "cik": "0001067983", "name": "BERKSHIRE HATHAWAY INC" }, { "ticker": "BRK-A", "cik": "0001067983", "name": "BERKSHIRE HATHAWAY INC" } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/sources": { "get": { "operationId": "dataSources", "summary": "Data Sources", "description": "Data Sources endpoint of the Company Financials API. Costs 10 tokens per call.", "externalDocs": { "url": "https://dataandapis.com/apis/company-financials/data-sources" }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "sources": [ { "slug": "sec-company-tickers", "name": "SEC company_tickers.json", "url": "https://www.sec.gov/files/company_tickers.json", "licence": "US public domain", "cadence": "daily, edge-cached 24h" }, { "slug": "sec-companyfacts", "name": "SEC EDGAR XBRL companyfacts API", "url": "https://data.sec.gov/api/xbrl/companyfacts/CIK##########.json", "licence": "US public domain", "cadence": "updated as filings are processed; edge-cached 24h" }, { "slug": "sec-submissions", "name": "SEC EDGAR submissions API", "url": "https://data.sec.gov/submissions/CIK##########.json", "licence": "US public domain", "cadence": "daily, edge-cached 24h" } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/financials/{ticker}": { "get": { "operationId": "keyFinancials", "summary": "Key Financials", "description": "Key Financials endpoint of the Company Financials API. Costs 10 tokens per call.", "externalDocs": { "url": "https://dataandapis.com/apis/company-financials/key-financials" }, "parameters": [ { "name": "ticker", "in": "path", "required": true, "schema": { "type": "string" }, "example": "AAPL" }, { "name": "years", "in": "query", "required": false, "schema": { "type": "string" }, "example": "2" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "ticker": "AAPL", "cik": "0000320193", "name": "Apple Inc.", "years_requested": 2, "taxonomy": "us-gaap", "source": "SEC EDGAR XBRL companyfacts (US public-domain filings)", "source_url": "https://www.sec.gov/search-filings/edgar-application-programming-interfaces", "coverage": "US-listed SEC filers; annual (10-K / 20-F / 40-F) values only", "financials": { "revenue": { "concepts_used": [ "RevenueFromContractWithCustomerExcludingAssessedTax", "Revenues", "SalesRevenueNet" ], "unit": "USD", "annual": [ { "fiscal_year": 2024, "period_start": "2023-10-01", "period_end": "2024-09-28", "value": 391035000000, "form": "10-K", "filed": "2025-10-31", "accession": "0000320193-25-000079", "concept": "RevenueFromContractWithCustomerExcludingAssessedTax" }, { "fiscal_year": 2025, "period_start": "2024-09-29", "period_end": "2025-09-27", "value": 416161000000, "form": "10-K", "filed": "2025-10-31", "accession": "0000320193-25-000079", "concept": "RevenueFromContractWithCustomerExcludingAssessedTax" } ] }, "net_income": { "concepts_used": [ "NetIncomeLoss" ], "unit": "USD", "annual": [ { "fiscal_year": 2024, "period_start": "2023-10-01", "period_end": "2024-09-28", "value": 93736000000, "form": "10-K", "filed": "2025-10-31", "accession": "0000320193-25-000079", "concept": "NetIncomeLoss" }, { "fiscal_year": 2025, "period_start": "2024-09-29", "period_end": "2025-09-27", "value": 112010000000, "form": "10-K", "filed": "2025-10-31", "accession": "0000320193-25-000079", "concept": "NetIncomeLoss" } ] }, "eps_diluted": { "concepts_used": [ "EarningsPerShareDiluted" ], "unit": "USD/shares", "annual": [ { "fiscal_year": 2024, "period_start": "2023-10-01", "period_end": "2024-09-28", "value": 6.08, "form": "10-K", "filed": "2025-10-31", "accession": "0000320193-25-000079", "concept": "EarningsPerShareDiluted" }, { "fiscal_year": 2025, "period_start": "2024-09-29", "period_end": "2025-09-27", "value": 7.46, "form": "10-K", "filed": "2025-10-31", "accession": "0000320193-25-000079", "concept": "EarningsPerShareDiluted" } ] }, "total_assets": { "concepts_used": [ "Assets" ], "unit": "USD", "annual": [ { "fiscal_year": 2024, "period_end": "2024-09-28", "value": 364980000000, "form": "10-K", "filed": "2025-10-31", "accession": "0000320193-25-000079", "concept": "Assets" }, { "fiscal_year": 2025, "period_end": "2025-09-27", "value": 359241000000, "form": "10-K", "filed": "2025-10-31", "accession": "0000320193-25-000079", "concept": "Assets" } ] } } } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/concept/{ticker}/{concept}": { "get": { "operationId": "rawConcept", "summary": "Raw Concept", "description": "Raw Concept endpoint of the Company Financials API. Costs 10 tokens per call.", "externalDocs": { "url": "https://dataandapis.com/apis/company-financials/raw-concept" }, "parameters": [ { "name": "concept", "in": "path", "required": true, "schema": { "type": "string" }, "example": "NetIncomeLoss" }, { "name": "ticker", "in": "path", "required": true, "schema": { "type": "string" }, "example": "AAPL" }, { "name": "years", "in": "query", "required": false, "schema": { "type": "string" }, "example": "3" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "ticker": "AAPL", "cik": "0000320193", "concept": "NetIncomeLoss", "label": "Net Income (Loss) Attributable to Parent", "description": "The portion of profit or loss for the period, net of income taxes, which is attributable to the parent.", "unit": "USD", "annual": [ { "fiscal_year": 2023, "period_start": "2022-09-25", "period_end": "2023-09-30", "value": 96995000000, "form": "10-K", "filed": "2025-10-31", "accession": "0000320193-25-000079" }, { "fiscal_year": 2024, "period_start": "2023-10-01", "period_end": "2024-09-28", "value": 93736000000, "form": "10-K", "filed": "2025-10-31", "accession": "0000320193-25-000079" }, { "fiscal_year": 2025, "period_start": "2024-09-29", "period_end": "2025-09-27", "value": 112010000000, "form": "10-K", "filed": "2025-10-31", "accession": "0000320193-25-000079" } ], "source": "SEC EDGAR XBRL companyfacts (US public-domain filings)", "source_url": "https://www.sec.gov/search-filings/edgar-application-programming-interfaces", "coverage": "US-listed SEC filers; annual (10-K / 20-F / 40-F) values only" } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/concepts/{ticker}": { "get": { "operationId": "reportedConcepts", "summary": "Reported Concepts", "description": "Reported Concepts endpoint of the Company Financials API. Costs 10 tokens per call.", "externalDocs": { "url": "https://dataandapis.com/apis/company-financials/reported-concepts" }, "parameters": [ { "name": "ticker", "in": "path", "required": true, "schema": { "type": "string" }, "example": "AAPL" }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string" }, "example": "revenue" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "ticker": "AAPL", "cik": "0000320193", "count": 8, "concepts": [ { "concept": "ContractWithCustomerLiabilityRevenueRecognized", "label": "Contract with Customer, Liability, Revenue Recognized", "units": [ "USD" ] }, { "concept": "DeferredRevenueCurrent", "label": "Deferred Revenue, Current", "units": [ "USD" ] }, { "concept": "DeferredRevenueNoncurrent", "label": "Deferred Revenue, Noncurrent", "units": [ "USD" ] }, { "concept": "IncreaseDecreaseInDeferredRevenue", "label": "Increase (Decrease) in Deferred Revenue", "units": [ "USD" ] } ] } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } } }, "components": { "securitySchemes": { "ApiKey": { "type": "apiKey", "in": "header", "name": "X-Api-Key", "description": "Create a free key at https://dataandapis.com/sign-up. 500 tokens a month on the Free plan; this API costs 10 tokens per call." } } }, "security": [ { "ApiKey": [] } ] }