Get API key
FINANCIAL DATA / BETA

Filing-level XBRL facts & dimensions API

Read source-native XBRL instance facts with context, units, qualified names and segment dimensions.

What this endpoint returns

One verified manifest XBRL XML instance;2MB input and900KB bounded response.

  • facts
  • contexts
  • units
  • namespaces
  • contextRef
  • unitRef
  • decimals
  • precision
  • tuplePath

Make a request

Use an API key from your dashboard. Replace any uppercase CIK, ACCESSION, or DOCUMENT placeholders with actual identifiers. For document workflows, obtain the accession from filing metadata and choose a filename from the accession’s document manifest; filenames are not inferred from company names.

curl --fail-with-body "https://sec-api.dev/api/v1/xbrl-instance?cik=CIK&accession=ACCESSION&document=INSTANCE.xml" \
  -H "Authorization: Bearer $SEC_API_KEY"

Keep the source context

Successful JSON responses provide a data envelope and source metadata. Store the original resource URL, fetchedAt retrieval time, and stale flag beside results. A retrieval timestamp is not the SEC’s publication timestamp. Use the documented pagination fields instead of assuming the first response is complete. Never treat a failed request as an empty filing or position set.

Limits that affect your application

XML instance only, not inline-XBRL HTML. No taxonomy/calculation validation, normalized statements, cross-filing segments or full-market corpus.

Account rate limits and request quotas apply. Respect Retry-After when supplied and bound retries. Source-format differences may produce explicit validation errors; retain the request ID when investigating. This API makes public data accessible, but does not guarantee the correctness of a filer’s financial disclosures.

Read the endpoint guide · Follow runnable workflows · Data quality and coverage

Build the next step

  • Reported XBRL facts — Query reported companyfacts observations without dropping units or periods.
  • Financial observation series — Select annual, quarterly or instant reported observations with exact periods, filing provenance and explicit conflict handling.

Browse all products →

Source reference: SEC EDGAR API documentation and SEC technical specifications.