{"openapi":"3.1.0","info":{"title":"SEC EDGAR Company Filings & Financials","version":"0.1.0","description":"U.S. public-company filings and financials: resolve a ticker or company name to a CIK, list filing history (10-K, 10-Q, 8-K and more), and read exact XBRL financial facts (revenue, net income, assets) from as-filed statements. Authoritative, as-reported numbers.","x-guidance":"U.S. public-company filings and financials: resolve a ticker or company name to a CIK, list filing history (10-K, 10-Q, 8-K and more), and read exact XBRL financial facts (revenue, net income, assets) from as-filed statements. Authoritative, as-reported numbers. Each operation is an HTTP POST to its /v1/<operation> path with a JSON request body (see each operation's requestBody schema) and returns a JSON response. Endpoints are paid per successful call via x402 or MPP (USDC on Base); an unpaid request returns 402 with payment metadata in the WWW-Authenticate header.","contact":{"email":"hello@openverbs.com"}},"x-discovery":{"ownershipProofs":["0xb1401a71756f51464a9962db12f1eb3e9522490cd20010b06d00cf7b7770acfd5f79721f9dfdf2643f8cecd29af3bde9ec133941a386042b32d9886053a70de61b","0xc1c1f11793e18a00fcb7072421f26e89fb75b6aa517fa84370564991f4b10efa024f6f57e4e67eefd20cf46cc01fc5a62d793fa8fbcda04f26c946a3433d73f91b","0x676b474af0ef9ed4809b5d12d2e789b36e52d56215b21f601d71f76620e36ec630347116a7b2b349a3c3681e5db0fbfa76c4169a676b6d6f27864d0e5017284a1c","0xc2ab96522515ed9e9bc4f1a241b774bd48df42e951ddbf7f6aa8fc76f5a96a20421703e1ec402ce7eb1e4eabea3b6e4e4129cf39d56ea91cf4fcf38561fc94fc1c"]},"servers":[{"url":"https://edgar.openverbs.com"}],"paths":{"/health":{"get":{"summary":"Health check","security":[],"responses":{"200":{"description":"Healthy","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"service":{"type":"string"},"version":{"type":"string"}}}}}}}}},"/v1/lookup":{"post":{"summary":"Resolve a ticker or company name to a CIK","description":"Resolve a stock ticker symbol or company name to its Central Index Key (CIK) - the identifier every other EDGAR endpoint keys on. Exact ticker matches rank first, then company-name prefix/substring matches. Returns each match's zero-padded CIK, numeric CIK, ticker and official company title. Paid endpoint (x402 + MPP). Price: $0.006000 USDC per successful payment.","tags":["cik lookup api","ticker to cik","sec company lookup","resolve ticker symbol","edgar company search"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":200,"description":"Ticker symbol (e.g. \"AAPL\") or company name (e.g. \"Apple\") to resolve."},"limit":{"type":"integer","minimum":1,"maximum":25,"default":10,"description":"Max matches to return (default 10)."}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"`{ query, count, results: [{ cik, cikNumber, ticker, title }], source, stale, cachedAt? }`.","content":{"application/json":{"schema":{"type":"object","description":"`{ query, count, results: [{ cik, cikNumber, ticker, title }], source, stale, cachedAt? }`."}}}},"400":{"description":"Invalid request; no payment is attempted"},"402":{"description":"Payment required; x402/MPP metadata returned in headers"},"502":{"description":"Upstream provider error after payment verification"}},"x-payment-info":{"amount":"6000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Resolve a stock ticker symbol or company name to its Central Index Key (CIK) - the identifier every other EDGAR endpoint keys on. Exact ticker matches rank first, then company-name prefix/substring matches. Returns each match's zero-padded CIK, numeric CIK, ticker and official company title.","method":"tempo","preferredOffer":"mpp-tempo","price":{"mode":"fixed","currency":"USD","amount":"0.006000"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"evm","intent":"charge","network":"8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"tempo","intent":"charge","network":"4217","currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}}],"network":"4217","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A","offers":[{"amount":"6000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Resolve a stock ticker symbol or company name to its Central Index Key (CIK) - the identifier every other EDGAR endpoint keys on. Exact ticker matches rank first, then company-name prefix/substring matches. Returns each match's zero-padded CIK, numeric CIK, ticker and official company title.","intent":"charge","method":"evm","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"},{"amount":"6000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Resolve a stock ticker symbol or company name to its Central Index Key (CIK) - the identifier every other EDGAR endpoint keys on. Exact ticker matches rank first, then company-name prefix/substring matches. Returns each match's zero-padded CIK, numeric CIK, ticker and official company title.","intent":"charge","method":"tempo","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}]}}},"/v1/filings":{"post":{"summary":"List a company's recent SEC filings","description":"SEC filings API: list a company's recent SEC EDGAR filings (10-K, 10-Q, 8-K, Form 4, S-1) by ticker or CIK, optionally filtered by form type. Each filing has its accession number, form, filing/report dates, primary document, XBRL flag and a direct as-filed document URL, plus company name, tickers, exchanges and SIC code. Paid endpoint (x402 + MPP). Price: $0.006000 USDC per successful payment.","tags":["sec filings api","sec filings lookup","list company filings","10-k 10-q search","edgar filing history","company filing api","sec","edgar","filings","10-k","10-q","8-k","stocks"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cik":{"type":"string","minLength":1,"maxLength":10,"description":"Central Index Key (1-10 digits). Provide this or `ticker`."},"ticker":{"type":"string","minLength":1,"maxLength":10,"description":"Ticker symbol, e.g. \"AAPL\". Provide this or `cik`."},"form":{"type":"string","minLength":1,"maxLength":20,"description":"Optional exact form type filter, e.g. \"10-K\"."},"limit":{"type":"integer","minimum":1,"maximum":100,"default":20,"description":"Max filings to return (default 20)."}},"required":[],"additionalProperties":false},"example":{"ticker":"AAPL","form":"10-K","limit":5}}}},"responses":{"200":{"description":"`{ cik, found, name, tickers, exchanges, sic, sicDescription, form, count, filings: [{ accessionNumber, form, filingDate, reportDate, primaryDocument, primaryDocDescription, isXBRL, url }], source, stale, cachedAt? }`.","content":{"application/json":{"schema":{"type":"object","description":"`{ cik, found, name, tickers, exchanges, sic, sicDescription, form, count, filings: [{ accessionNumber, form, filingDate, reportDate, primaryDocument, primaryDocDescription, isXBRL, url }], source, stale, cachedAt? }`."}}}},"400":{"description":"Invalid request; no payment is attempted"},"402":{"description":"Payment required; x402/MPP metadata returned in headers"},"502":{"description":"Upstream provider error after payment verification"}},"x-payment-info":{"amount":"6000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"SEC filings API: list a company's recent SEC EDGAR filings (10-K, 10-Q, 8-K, Form 4, S-1) by ticker or CIK, optionally filtered by form type. Each filing has its accession number, form, filing/report dates, primary document, XBRL flag and a direct as-filed document URL, plus company name, tickers, exchanges and SIC code.","method":"tempo","preferredOffer":"mpp-tempo","price":{"mode":"fixed","currency":"USD","amount":"0.006000"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"evm","intent":"charge","network":"8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"tempo","intent":"charge","network":"4217","currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}}],"network":"4217","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A","offers":[{"amount":"6000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"SEC filings API: list a company's recent SEC EDGAR filings (10-K, 10-Q, 8-K, Form 4, S-1) by ticker or CIK, optionally filtered by form type. Each filing has its accession number, form, filing/report dates, primary document, XBRL flag and a direct as-filed document URL, plus company name, tickers, exchanges and SIC code.","intent":"charge","method":"evm","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"},{"amount":"6000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"SEC filings API: list a company's recent SEC EDGAR filings (10-K, 10-Q, 8-K, Form 4, S-1) by ticker or CIK, optionally filtered by form type. Each filing has its accession number, form, filing/report dates, primary document, XBRL flag and a direct as-filed document URL, plus company name, tickers, exchanges and SIC code.","intent":"charge","method":"tempo","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}]}}},"/v1/facts":{"post":{"summary":"Read an XBRL financial fact for a company","description":"Read a single XBRL financial concept for a company (by CIK or ticker) from its as-filed statements. Give the concept's XBRL tag (e.g. Revenues, NetIncomeLoss, Assets, EarningsPerShareDiluted) and optionally the taxonomy (default us-gaap, also dei). Returns the label and, per unit (USD, shares), recent datapoints with period end, value, fiscal year/period, form, filing date and accession. Bounded, as-reported output. Paid endpoint (x402 + MPP). Price: $0.006000 USDC per successful payment.","tags":["xbrl facts api","read financial facts","sec companyconcept lookup","edgar revenue lookup","as filed financial data"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cik":{"type":"string","minLength":1,"maxLength":10,"description":"Central Index Key (1-10 digits). Provide this or `ticker`."},"ticker":{"type":"string","minLength":1,"maxLength":10,"description":"Ticker symbol, e.g. \"AAPL\". Provide this or `cik`."},"taxonomy":{"type":"string","minLength":1,"maxLength":20,"default":"us-gaap","description":"XBRL taxonomy, usually \"us-gaap\" (also \"dei\", \"ifrs-full\")."},"concept":{"type":"string","minLength":1,"maxLength":80,"description":"XBRL concept tag, e.g. \"Revenues\", \"NetIncomeLoss\", \"Assets\"."},"limit":{"type":"integer","minimum":1,"maximum":50,"default":8,"description":"Max datapoints per unit, most recent first (default 8)."}},"required":["concept"],"additionalProperties":false},"example":{"ticker":"AAPL","concept":"Revenues","limit":5}}}},"responses":{"200":{"description":"`{ cik, found, entityName, taxonomy, concept, label, description, units: { <unit>: [{ end, start, val, fy, fp, form, filed, frame, accession }] }, latest, source, stale, cachedAt? }`.","content":{"application/json":{"schema":{"type":"object","description":"`{ cik, found, entityName, taxonomy, concept, label, description, units: { <unit>: [{ end, start, val, fy, fp, form, filed, frame, accession }] }, latest, source, stale, cachedAt? }`."}}}},"400":{"description":"Invalid request; no payment is attempted"},"402":{"description":"Payment required; x402/MPP metadata returned in headers"},"502":{"description":"Upstream provider error after payment verification"}},"x-payment-info":{"amount":"6000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Read a single XBRL financial concept for a company (by CIK or ticker) from its as-filed statements. Give the concept's XBRL tag (e.g. Revenues, NetIncomeLoss, Assets, EarningsPerShareDiluted) and optionally the taxonomy (default us-gaap, also dei). Returns the label and, per unit (USD, shares), recent datapoints with period end, value, fiscal year/period, form, filing date and accession. Bounded, as-reported output.","method":"tempo","preferredOffer":"mpp-tempo","price":{"mode":"fixed","currency":"USD","amount":"0.006000"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"evm","intent":"charge","network":"8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"tempo","intent":"charge","network":"4217","currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}}],"network":"4217","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A","offers":[{"amount":"6000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Read a single XBRL financial concept for a company (by CIK or ticker) from its as-filed statements. Give the concept's XBRL tag (e.g. Revenues, NetIncomeLoss, Assets, EarningsPerShareDiluted) and optionally the taxonomy (default us-gaap, also dei). Returns the label and, per unit (USD, shares), recent datapoints with period end, value, fiscal year/period, form, filing date and accession. Bounded, as-reported output.","intent":"charge","method":"evm","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"},{"amount":"6000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Read a single XBRL financial concept for a company (by CIK or ticker) from its as-filed statements. Give the concept's XBRL tag (e.g. Revenues, NetIncomeLoss, Assets, EarningsPerShareDiluted) and optionally the taxonomy (default us-gaap, also dei). Returns the label and, per unit (USD, shares), recent datapoints with period end, value, fiscal year/period, form, filing date and accession. Bounded, as-reported output.","intent":"charge","method":"tempo","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}]}}},"/v1/financials":{"post":{"summary":"Company financial statements snapshot","description":"Company financials API: one-call snapshot for a US public company (by ticker or CIK) from as-filed SEC XBRL statements — revenue, cost of revenue, gross profit, operating income, net income, EPS (basic/diluted), total assets, total liabilities, stockholders equity, cash, operating cash flow and shares outstanding, each with the latest fiscal-year value. Unknown company returns found=false. Paid endpoint (x402 + MPP). Price: $0.008000 USDC per successful payment.","tags":["company financials api","financial statements api","earnings api","stock fundamentals api","income statement api","balance sheet api","sec financials","financials","sec","edgar","xbrl","revenue","eps","stocks"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cik":{"type":"string","minLength":1,"maxLength":10,"description":"Central Index Key (1-10 digits). Provide this or `ticker`."},"ticker":{"type":"string","minLength":1,"maxLength":10,"description":"Ticker symbol, e.g. \"AAPL\". Provide this or `cik`."}},"additionalProperties":false},"example":{"ticker":"AAPL"}}}},"responses":{"200":{"description":"`{ cik, found, entityName, ticker, currency, metrics: { <line item>: { unit, tag, annual: { val, end, fy, fp, form, filed } | null, latest: { val, end, fy, fp, form, filed } | null } }, source, stale, cachedAt? }`. Line items: revenue, costOfRevenue, grossProfit, operatingIncome, netIncome, epsBasic, epsDiluted, totalAssets, totalLiabilities, stockholdersEquity, cashAndEquivalents, operatingCashFlow, sharesOutstanding.","content":{"application/json":{"schema":{"type":"object","description":"`{ cik, found, entityName, ticker, currency, metrics: { <line item>: { unit, tag, annual: { val, end, fy, fp, form, filed } | null, latest: { val, end, fy, fp, form, filed } | null } }, source, stale, cachedAt? }`. Line items: revenue, costOfRevenue, grossProfit, operatingIncome, netIncome, epsBasic, epsDiluted, totalAssets, totalLiabilities, stockholdersEquity, cashAndEquivalents, operatingCashFlow, sharesOutstanding."}}}},"400":{"description":"Invalid request; no payment is attempted"},"402":{"description":"Payment required; x402/MPP metadata returned in headers"},"502":{"description":"Upstream provider error after payment verification"}},"x-payment-info":{"amount":"8000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Company financials API: one-call snapshot for a US public company (by ticker or CIK) from as-filed SEC XBRL statements — revenue, cost of revenue, gross profit, operating income, net income, EPS (basic/diluted), total assets, total liabilities, stockholders equity, cash, operating cash flow and shares outstanding, each with the latest fiscal-year value. Unknown company returns found=false.","method":"tempo","preferredOffer":"mpp-tempo","price":{"mode":"fixed","currency":"USD","amount":"0.008000"},"protocols":[{"x402":{"scheme":"exact","network":"eip155:8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"evm","intent":"charge","network":"8453","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}},{"mpp":{"method":"tempo","intent":"charge","network":"4217","currency":"0x20c000000000000000000000b9537d11c60e8b50","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}}],"network":"4217","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A","offers":[{"amount":"8000","currency":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","description":"Company financials API: one-call snapshot for a US public company (by ticker or CIK) from as-filed SEC XBRL statements — revenue, cost of revenue, gross profit, operating income, net income, EPS (basic/diluted), total assets, total liabilities, stockholders equity, cash, operating cash flow and shares outstanding, each with the latest fiscal-year value. Unknown company returns found=false.","intent":"charge","method":"evm","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"},{"amount":"8000","currency":"0x20c000000000000000000000b9537d11c60e8b50","description":"Company financials API: one-call snapshot for a US public company (by ticker or CIK) from as-filed SEC XBRL statements — revenue, cost of revenue, gross profit, operating income, net income, EPS (basic/diluted), total assets, total liabilities, stockholders equity, cash, operating cash flow and shares outstanding, each with the latest fiscal-year value. Unknown company returns found=false.","intent":"charge","method":"tempo","recipient":"0xb3f4de103F34b99f0Da19B4F16D6B53a14C2194A"}]}}}},"x-service-info":{"categories":["finance"],"docs":{"homepage":"https://edgar.openverbs.com","apiReference":"https://edgar.openverbs.com/openapi.json"}}}