Get API key
FINANCIAL DATA / AVAILABLE

Financial observation series API

Select annual, quarterly or instant reported observations with exact periods, filing provenance and explicit conflict handling.

What this endpoint returns

One exact companyfacts taxonomy/concept/unit; source-backed period selection with optional filing-date cutoff.

  • start / end
  • value / ambiguous
  • conflictingValues
  • observationCount
  • filingUrl
  • meta.snapshotId

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/financial-series/320193?taxonomy=us-gaap&concept=RevenueFromContractWithCustomerExcludingAssessedTax&unit=USD&period=annual" \
  -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

No normalized statements, segment dimensions, custom taxonomy expansion, currency conversion or derived fourth quarters. asOf filters reported filing dates rather than historical API availability.

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.

Browse all products →

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