Docs / API reference

GET `/v1/xbrl/{ticker|cik}`

The full XBRL-to-JSON converter. By default returns the normalized income statement, balance sheet and cash flow across every reported period, plus a concepts_index of every us-gaap/dei tag the filer reports. Pass concept= to pull the raw time series for any specific tag — the complete converter, not just the curated fundamentals.

Parameters

Param	In	Values
`ident`	path	Ticker (`AAPL`) or CIK (`320193`)
`period`	query	`annual` (default) or `quarterly`
`limit`	query	Max periods per statement, 1–100 (default 40)
`concept`	query	Comma-separated us-gaap/dei tag(s), e.g. `Revenues,Assets`. Omit for normalized statements + the concept index

Request — normalized statements + concept index

curl "https://api.edgrapi.com/v1/xbrl/AAPL" -H "X-API-Key: edgr_..."

Response

{
  "ticker": "AAPL", "cik": "0000320193", "company": "Apple Inc.",
  "period": "annual", "currency": "USD",
  "income_statement": [ { "period": "2025", "revenue": 416161000000, "net_income": 112010000000 } ],
  "balance_sheet": [ { "period": "2025", "total_assets": 344085000000 } ],
  "cash_flow": [ { "period": "2025", "operating_cash_flow": 118254000000, "free_cash_flow": 108807000000 } ],
  "shares_outstanding": 14840000000,
  "concepts_index": [
    { "tag": "Assets", "namespace": "us-gaap", "label": "Assets", "units": [ "USD" ], "datapoints": 62 },
    { "tag": "Revenues", "namespace": "us-gaap", "label": "Revenues", "units": [ "USD" ], "datapoints": 41 }
  ],
  "source": "SEC EDGAR companyfacts"
}

Pull any raw tag

curl "https://api.edgrapi.com/v1/xbrl/AAPL?concept=ResearchAndDevelopmentExpense" -H "X-API-Key: edgr_..."

{
  "ticker": "AAPL", "cik": "0000320193", "company": "Apple Inc.", "count": 1,
  "concepts": {
    "ResearchAndDevelopmentExpense": {
      "tag": "ResearchAndDevelopmentExpense", "namespace": "us-gaap",
      "label": "Research and Development Expense",
      "units": { "USD": [ { "val": 31370000000, "start": "2023-10-01", "end": "2024-09-28",
                            "fy": 2024, "fp": "FY", "form": "10-K", "filed": "2024-11-01",
                            "accn": "0000320193-24-000123" } ] } }
  },
  "missing": [],
  "source": "SEC EDGAR companyfacts (raw concept series)"
}

Discover valid tags from the concepts_index in the default response. Unknown tags come back under missing; a query where every tag is unknown returns count: 0 and is free.

One filing's concepts

GET /v1/xbrl/by-accession/{accession} returns every XBRL concept reported in a single filing:

curl "https://api.edgrapi.com/v1/xbrl/by-accession/0000320193-24-000123" -H "X-API-Key: edgr_..."

Cost: 3 credits. Data source: SEC EDGAR companyfacts (numeric XBRL facts).