# XBRL API for SEC financial data

Canonical: https://sec-api.dev/xbrl-api

> sec-api.dev's XBRL API returns SEC XBRL financial data as JSON two ways: GET /api/v1/facts/{cik} lists every fact a company has reported in a standard taxonomy (us-gaap, ifrs-full, dei) with its unit, period, form, fiscal year and accession, filterable by concept, and GET /api/v1/xbrl-instance reads one filing's instance or Inline XBRL document with contexts and dimensions intact; both keep values as filed and work on the free plan.

sec-api.dev, not sec-api.io. Checked 2026-11-13.

**Free plan:** 100 API requests a month, 30 a minute, no credit card. Get a key: https://sec-api.dev/sign-up?ref=ai-claudebot

## Key facts

Endpoint facts as of November 13, 2026.

| Endpoint | What it returns | Filters |
| --- | --- | --- |
| GET /api/v1/facts/{cik} | All reported facts for a company across filings (SEC companyfacts) | taxonomy, concept, unit, limit (max 500), offset |
| GET /api/v1/xbrl-instance | Facts, contexts, units and dimensions from one filing's XBRL or Inline XBRL document | cik, accession, document, concept (inline), limit, offset |
| GET /api/v1/financial-series/{cik} | Source-backed annual or quarterly series for one concept | see the API reference |
| Plans | Every plan. Free: 100 requests every month, no card | Builder $29/month (50,000 requests), Scale $99/month (250,000 requests) |

## Example: Apple's total assets

Apple reported total assets of $404,548,000,000 at September 26, 2026 in its 10-K filed November 3, 2026. The frame CY2026Q3I marks an instant at the end of calendar Q3 2026, which the SEC assigns so that values from different companies can be lined up.

Request:

```bash
curl "https://sec-api.dev/api/v1/facts/320193?taxonomy=us-gaap&concept=Assets&unit=USD" -H "Authorization: Bearer $SEC_API_KEY"
```

Row from the response (real value; description field and meta omitted):

```json
{
  "data": [
    {
      "taxonomy": "us-gaap",
      "concept": "Assets",
      "label": "Assets",
      "unit": "USD",
      "value": 404548000000,
      "end": "2026-09-26",
      "filed": "2026-11-03",
      "accessionNumber": "0000320193-26-000026",
      "form": "10-K",
      "fiscalYear": 2026,
      "fiscalPeriod": "FY",
      "frame": "CY2026Q3I"
    }
  ],
  "pagination": {
    "limit": 1,
    "offset": 0
  }
}
```

## Company facts or one filing?

- Use /facts for time series and screening: one call per company, every period, standard taxonomies only, as aggregated by the SEC.
- Use /xbrl-instance when you need what one filing says exactly: company-specific extension concepts, segment and dimension members, and the context of every value.
- [XBRL concept pages](https://sec-api.dev/xbrl-concepts) [ list common us-gaap concepts and what they mean.](https://sec-api.dev/xbrl-concepts)

## Other XBRL APIs

The SEC's own data.sec.gov offers companyfacts, companyconcept and frames JSON for free with no key, within 10 requests a second. XBRL US runs an XBRL API over its database of SEC filings. filings.xbrl.org has a public API for ESEF filings from Europe. sec-api.dev adds instance-level parsing, a key, a quota, source metadata and an MCP server.

## FAQ

### What is an XBRL API?

An API that returns the tagged financial facts companies file in XBRL, such as Revenues or Assets, as structured data with their units, periods and filing references, so you do not parse XBRL documents yourself.

### Is there a free XBRL API for SEC filings?

Yes. The SEC's data.sec.gov XBRL APIs are free with no key. sec-api.dev's XBRL endpoints are free for 100 requests every month, no card.

### Does it include Inline XBRL?

Yes. GET /api/v1/xbrl-instance reads Inline XBRL XHTML documents as well as standalone instance XML, keeping the original text and scale of each fact.

### Are values standardized across companies?

No. Values are returned as filed. Concepts and frames make them comparable, but no restatement or normalization is applied.

## Sources

- [SEC: EDGAR APIs (XBRL data)](https://www.sec.gov/search-filings/edgar-application-programming-interfaces)
- [Apple 10-K filed November 3, 2026](https://www.sec.gov/Archives/edgar/data/320193/000032019326000026/)
- [XBRL US API](https://xbrl.us/tools-and-services/api-access/)
- [filings.xbrl.org API](https://filings.xbrl.org/docs/api)

## Related

- [XBRL companyfacts API](https://sec-api.dev/xbrl-companyfacts-api)
- [XBRL instance documentation](https://sec-api.dev/docs/xbrl-instance)
- [XBRL concepts](https://sec-api.dev/xbrl-concepts)
- [SEC EDGAR API](https://sec-api.dev/sec-edgar-api)
- [Pricing](https://sec-api.dev/pricing)

---
Independent. Not affiliated with, endorsed by, or sponsored by the U.S. Securities and Exchange Commission. Data is reproduced from public SEC filings and datasets. Not investment advice. Not affiliated with sec-api.io.
