Reported XBRL facts API
Query reported companyfacts observations without dropping units or periods.
What this endpoint returns
SEC companyfacts observations with exact taxonomy/concept/unit filters.
conceptunitvaluestartendaccessionNumber
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/facts/320193?concept=Assets&unit=USD" \
-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
Not standardized financial statements, currency conversion, or a filing-level XBRL converter.
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
- Financial observation series — Select annual, quarterly or instant reported observations with exact periods, filing provenance and explicit conflict handling.
Source reference: SEC EDGAR API documentation and SEC technical specifications.