Skip to main content
XBRL (eXtensible Business Reporting Language) is the structured data format behind SEC financial filings. It is useful but painful to work with directly — taxonomy versions change, extension elements vary by company, and the XML structure requires specialized parsers. SEC API does the parsing for you. Get normalized, JSON-formatted financial data from any XBRL-tagged SEC filing through a simple REST API.

Evaluate this workflow

Test facts, statements, provenance, and refresh economics before scaling.

Pricing and limits

Check plan, budget, and quota behavior for repeated statement refreshes.

Statements and facts

Review the product-level API page.

​
The XBRL problem

Working with raw XBRL means dealing with:
  • Multiple taxonomy versions (US-GAAP 2014 through 2024, IFRS, SEC-specific extensions)
  • Company-specific extensions that need manual mapping
  • Instance documents, schemas, calculation linkbases, and presentation linkbases — all separate files
  • Inline XBRL (iXBRL) embedded in HTML that requires a different parser
  • Inconsistent tagging where the same concept uses different elements across companies
SEC API normalizes all of this into a consistent JSON schema.

​
Quick start

Pull normalized financial statements (parsed from XBRL): 
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/statements/all?ticker=MSFT&period=annual&limit=1"
Pull individual XBRL facts: 
curl -H "x-api-key: $SECAPI_API_KEY" \
  "https://api.secapi.ai/v1/facts?ticker=MSFT&tag=Revenues&period=annual&limit=4"

{
  "data": [
    {
      "concept": "Revenues",
      "value": 245122000000,
      "unit": "USD",
      "period_end": "2024-06-30",
      "fiscal_year": 2024,
      "form": "10-K",
      "taxonomy": "us-gaap/2024",
      "accession_number": "0000789019-24-000076"
    }
  ]
}

​
What you get

​
Normalized financial statements

The /v1/statements endpoint maps XBRL facts to a consistent schema across all companies:
  • Income statement: Revenue, COGS, gross profit, operating income, net income, EPS
  • Balance sheet: Total assets, total liabilities, equity, cash, debt
  • Cash flow statement: Operating, investing, and financing cash flows

​
Raw XBRL facts

The /v1/facts endpoint gives you access to any XBRL concept, including company-specific extensions:
  • Query by concept name (e.g., Revenues, Assets, NetIncomeLoss)
  • Filter by period (annual/quarterly), date range, and company
  • Get the full provenance trail: taxonomy version, filing reference, and unit

​
API endpoints

EndpointDescription
GET /v1/statements/allNormalized income, balance sheet, and cash flow
GET /v1/factsIndividual XBRL facts by concept
GET /v1/filingsFind filings that contain XBRL data
For product-level evaluation, see the Statements and Facts API page and the broader SEC API catalog.

​
Use cases

  • Financial modeling: Pull structured income statements and balance sheets directly into models
  • Multi-company comparison: Compare financials across companies using a normalized schema
  • Time series analysis: Track any XBRL concept across quarters and years
  • Data validation: Cross-reference normalized statements against raw facts for audit trails
  • AI/LLM pipelines: Feed structured financials to AI agents without manual extraction

​
Why SEC API over raw XBRL

FeatureSEC APIRaw XBRLCalcbenchXBRL US API
Normalized statementsYesNoYesNo
Raw fact accessYesYes (with parsing)PartialYes
JSON outputYesXMLCSV/JSONJSON
Multi-year time seriesOne callMultiple downloadsYesYes
Company extensions mappedYesManualPartialNo
Real-time availabilityMinutes after filingHoursHoursHours
SDK supportPython + JSNoNoNo

​
Get started

Get your API key

Start pulling structured financial data in under 60 seconds.