{"openapi": "3.1.0", "info": {"title": "FinancialFilings API: pay per call", "version": "1.4.0", "description": "Regulatory filings and company data, paid per request over x402. Licensed for the buyer's own internal use only; redistribution, resale, sublicensing and public display are not permitted.", "x-guidance": "Each operation answers HTTP 402 with an x402 v2 offer in the PAYMENT-REQUIRED header: the exact price in USDC on Base, paid per call with no account. A request with an API key in X-API-Key is billed to that account instead. Prices are in US dollars; the markdown price depends on the filing type.", "termsOfService": "https://financialfilings.com/api-terms/#keyless-access", "contact": {"email": "api@financialfilings.com"}}, "servers": [{"url": "https://api.financialreports.eu"}], "paths": {"/companies/": {"get": {"operationId": "company_list", "summary": "Search listed and delisted companies worldwide by name, ticker, ISIN or LEI, or filter by country. Returns the company IDs the filings and financials endpoints take.", "security": [], "parameters": [{"name": "search", "in": "query", "required": false, "schema": {"type": "string"}, "description": "Name, ticker, ISIN or LEI"}, {"name": "isin", "in": "query", "required": false, "schema": {"type": "string"}, "description": "ISIN"}, {"name": "countries", "in": "query", "required": false, "schema": {"type": "string"}, "description": "ISO alpha-2 codes, comma-separated"}, {"name": "page_size", "in": "query", "required": false, "schema": {"type": "string"}, "description": "1-100"}], "x-payment-info": {"price": {"mode": "fixed", "currency": "USD", "amount": "0.01"}, "protocols": [{"x402": {"version": 2, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x966F7dD98beBC2d90a5E0F6E11C59e229435Ed06"}}]}, "responses": {"200": {"description": "The data, after the payment settles.", "content": {"application/json": {"schema": {"type": "object"}, "example": {"count": 1, "results": [{"id": 390, "name": "Siemens AG", "lei": "W38RGI023J3WT1HWRP32", "isins": ["DE0007236101"], "country_code": "DE"}]}}}}, "402": {"description": "Payment Required. PAYMENT-REQUIRED carries the x402 v2 offer."}}}}, "/companies/{id}/": {"get": {"operationId": "company_detail", "summary": "One company profile: name, description, ISINs, LEI, country, industry classification, listing status and investor-relations links.", "security": [], "parameters": [{"name": "id", "in": "path", "required": true, "schema": {"type": "integer"}, "description": "Numeric ID"}], "x-payment-info": {"price": {"mode": "fixed", "currency": "USD", "amount": "0.01"}, "protocols": [{"x402": {"version": 2, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x966F7dD98beBC2d90a5E0F6E11C59e229435Ed06"}}]}, "responses": {"200": {"description": "The data, after the payment settles.", "content": {"application/json": {"schema": {"type": "object"}, "example": {"id": 390, "name": "Siemens AG", "lei": "W38RGI023J3WT1HWRP32", "isins": ["DE0007236101"], "country_code": "DE"}}}}, "402": {"description": "Payment Required. PAYMENT-REQUIRED carries the x402 v2 offer."}}}}, "/filings/": {"get": {"operationId": "filing_list", "summary": "Regulatory filings (annual and interim reports, earnings releases, announcements) from stock exchanges and regulators worldwide, filterable by company, ISIN, filing type, country and release date.", "security": [], "parameters": [{"name": "company", "in": "query", "required": false, "schema": {"type": "string"}, "description": "Company ID"}, {"name": "company_isin", "in": "query", "required": false, "schema": {"type": "string"}, "description": "ISIN"}, {"name": "types", "in": "query", "required": false, "schema": {"type": "string"}, "description": "Filing type codes, comma-separated, e.g. 10-K"}, {"name": "countries", "in": "query", "required": false, "schema": {"type": "string"}, "description": "ISO alpha-2 codes, comma-separated"}, {"name": "release_datetime_from", "in": "query", "required": false, "schema": {"type": "string"}, "description": "ISO 8601 date"}, {"name": "page_size", "in": "query", "required": false, "schema": {"type": "string"}, "description": "1-100"}], "x-payment-info": {"price": {"mode": "fixed", "currency": "USD", "amount": "0.01"}, "protocols": [{"x402": {"version": 2, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x966F7dD98beBC2d90a5E0F6E11C59e229435Ed06"}}]}, "responses": {"200": {"description": "The data, after the payment settles.", "content": {"application/json": {"schema": {"type": "object"}, "example": {"count": 1, "results": [{"id": 9173276, "title": "Annual financial report 2024/2025", "release_datetime": "2025-12-03T00:00:00Z", "company": {"id": 390, "name": "Siemens AG"}}]}}}}, "402": {"description": "Payment Required. PAYMENT-REQUIRED carries the x402 v2 offer."}}}}, "/filings/{id}/": {"get": {"operationId": "filing_detail", "summary": "One regulatory filing: title, filing type, release date, fiscal period, company and document links.", "security": [], "parameters": [{"name": "id", "in": "path", "required": true, "schema": {"type": "integer"}, "description": "Numeric ID"}], "x-payment-info": {"price": {"mode": "fixed", "currency": "USD", "amount": "0.01"}, "protocols": [{"x402": {"version": 2, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x966F7dD98beBC2d90a5E0F6E11C59e229435Ed06"}}]}, "responses": {"200": {"description": "The data, after the payment settles.", "content": {"application/json": {"schema": {"type": "object"}, "example": {"id": 9173276, "title": "Annual financial report 2024/2025", "release_datetime": "2025-12-03T00:00:00Z", "company": {"id": 390, "name": "Siemens AG"}}}}}, "402": {"description": "Payment Required. PAYMENT-REQUIRED carries the x402 v2 offer."}}}}, "/filings/{id}/markdown/": {"get": {"operationId": "filing_markdown", "summary": "Full text of one regulatory filing as Markdown, converted from the original PDF or HTML, in windows of up to 200,000 characters (offset, limit). Suited to reading annual reports and announcements with an LLM.", "security": [], "parameters": [{"name": "id", "in": "path", "required": true, "schema": {"type": "integer"}, "description": "Numeric ID"}, {"name": "offset", "in": "query", "required": false, "schema": {"type": "string"}, "description": "Character offset, default 0"}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "string"}, "description": "Characters, 1-200000"}], "x-payment-info": {"price": {"mode": "dynamic", "currency": "USD", "min": "0.06", "max": "0.12"}, "protocols": [{"x402": {"version": 2, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x966F7dD98beBC2d90a5E0F6E11C59e229435Ed06"}}]}, "responses": {"200": {"description": "The data, after the payment settles.", "content": {"text/markdown": {"schema": {"type": "string"}, "example": "# Annual financial report 2024/2025\n\n<!-- page 1 -->\n..."}}}, "402": {"description": "Payment Required. PAYMENT-REQUIRED carries the x402 v2 offer."}}}}, "/companies/{id}/financials/": {"get": {"operationId": "company_financials", "summary": "A company's standardized income statement, balance sheet and cash flow statement by fiscal period.", "security": [], "parameters": [{"name": "id", "in": "path", "required": true, "schema": {"type": "integer"}, "description": "Numeric ID"}, {"name": "statement_type", "in": "query", "required": false, "schema": {"type": "string"}, "description": "IS, BS or CFS"}, {"name": "fiscal_year", "in": "query", "required": false, "schema": {"type": "string"}, "description": "Year, e.g. 2024"}], "x-payment-info": {"price": {"mode": "fixed", "currency": "USD", "amount": "0.40"}, "protocols": [{"x402": {"version": 2, "scheme": "exact", "network": "eip155:8453", "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "payTo": "0x966F7dD98beBC2d90a5E0F6E11C59e229435Ed06"}}]}, "responses": {"200": {"description": "The data, after the payment settles.", "content": {"application/json": {"schema": {"type": "object"}, "example": {"company_id": 100, "currency": {"code": "EUR"}, "periods": [{"fiscal_year": 2024, "fiscal_period": "FY", "statements": [{"statement_type": "IS", "line_items": [{"code": "revenue", "name": "Total Revenues", "value": "699767000.00", "currency": "EUR"}]}]}]}}}}, "402": {"description": "Payment Required. PAYMENT-REQUIRED carries the x402 v2 offer."}}}}}}