{"uid":"cap_41cSC0TFCw2luPWZS_4vp","slug":"sec-xbrl-financial-facts-api-f2d3412e","name":"SEC XBRL Financial Facts API","description":"Retrieve normalized, recent issuer-reported revenue, earnings, balance-sheet, cash-flow, and diluted-EPS facts from official SEC XBRL data.","url":"https://apiacre.com/v1/research/sec-financial-facts","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"metrics":{"type":"array","items":{"enum":["revenue","net_income","operating_income","total_assets","total_liabilities","stockholders_equity","cash_and_equivalents","operating_cash_flow","capital_expenditure","diluted_eps"],"type":"string"}},"periods":{"type":"integer"},"identifier":{"type":"string"},"period_type":{"enum":["annual","quarterly","both"],"type":"string"}}},"responseSchema":{"type":"json","example":{"data":{"cik":"0000320193","source":"https://data.sec.gov/api/xbrl/companyfacts/CIK0000320193.json","metrics":{"revenue":{"unit":"USD","label":"Revenue","concept":"RevenueFromContractWithCustomerExcludingAssessedTax","description":"Revenue from contracts with customers, excluding assessed tax.","observations":[{"fy":2025,"end":"2025-09-27","val":416161000000,"accn":"0000320193-25-000079","start":"2024-09-29"}]}},"taxonomy":"us-gaap","disclaimer":"Standardized issuer-reported XBRL facts only; verify filing context before us...","entityName":"Apple Inc.","periodType":"both","retrievedAt":"2026-08-09T00:00:00Z","missingMetrics":[],"periodsPerMetric":4},"meta":{"cached":false,"sources":[],"warnings":[],"duration_ms":42,"next_actions":[]},"service":"research.sec-financial-facts","version":"1","request_id":"018f1f54-7f38-7ba2-8dc3-5f90272d9f1a"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_C_2Q7ldXlfUZkHF3A48Hf","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves normalized issuer-reported financial data (revenue, earnings, balance sheet, cash flow, diluted EPS) from official SEC XBRL filings.","exampleAgentPrompt":"Pull the most recent SEC XBRL financial facts for Apple — I need revenue, diluted EPS, and cash flow from their latest issuer-reported filing.","exampleUseCases":[{"title":"Equity research fundamental screening","prompt":"Get me the latest SEC-reported revenue, net earnings, and diluted EPS for Microsoft from their XBRL filings so I can compare them to analyst estimates."},{"title":"Balance sheet health check","prompt":"Pull the most recent balance sheet facts for Tesla from official SEC XBRL data — I want total assets, total liabilities, and shareholders' equity."},{"title":"Cash flow trend analysis","prompt":"Retrieve the last few quarters of operating and free cash flow figures for Amazon as reported in their SEC XBRL filings."}],"resultDescription":"Returns a structured JSON object containing normalized, recent issuer-reported financial facts sourced from SEC XBRL data, including revenue, earnings, balance sheet line items, cash flow figures, and diluted EPS, all tagged with the relevant reporting period and filing metadata.","failureModes":["Company not found or invalid ticker/CIK returns 404 or empty result","Requested metric not available in XBRL data for that issuer returns null fields","SEC EDGAR data lag means very recent filings may not yet be indexed","Non-US companies without SEC filings cannot be queried","Rate limiting or payment failure returns 402 or 429 error"],"whenToPreferThis":"Prefer this endpoint when you need authoritative, issuer-reported financial data directly from SEC XBRL filings rather than third-party aggregators or estimated figures. Ideal for compliance-grade research, fundamental analysis, and any use case requiring official as-reported numbers with period tagging. Best suited for US-listed public companies that file with the SEC.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:55:12.851Z","isFirstParty":false}