How do I look up a company profile?
GET /api/v1/sec-filings/company?ticker=AAPL (or ?cik=320193) returns the resolved company profile from SEC submissions data.
SEC Filings API
EDGAR Company Lookup
Filing Feeds
XBRL Concept Facts
SEC EDGAR data. Structured and keyless.
Resolve any company by CIK or ticker, pull recent filings with form and date filters, or retrieve XBRL concept facts — all normalized from live SEC EDGAR data.
CIK / Ticker · resolutionFilings · form filteredXBRL · concept factsNo key · required upstream
Resolve any company, instantly.
This calls the live SEC Filings API against SEC EDGAR. Switch between company profile and recent filings.
Request builder
Ticker in, EDGAR data out.
GET /sec-filings/company
XBRL facts and catalog
GET /facts returns concept-level XBRL observations by taxonomy and tag. GET /catalog returns capability metadata and example forms.
Output preview
Live response from the API, plus the exact request to reproduce it.
Loading live filing data...
Why SEC Filings API
EDGAR data, normalized for you.
CIK or ticker resolution
Look up any company by SEC CIK or stock ticker — ticker requests are resolved through cached SEC mapping data.
Recent filing feeds
GET /filings returns normalized filing rows with form, filing date, accession number, and direct document URL.
Single and multi-form filtering
Filter by a single form or a comma-separated list, e.g. forms=10-K,10-Q,8-K, with sortable date order.
Date-range and pagination
fromDate/toDate bounds plus limit/offset pagination (up to 100 records, offset up to 2000).
XBRL concept facts
GET /facts resolves company concept data by taxonomy and tag, returning unit-specific observation arrays.
Catalog discovery
GET /catalog returns capability metadata and example form types for building dynamic pickers.
/api/v1/sec-filings
Endpoints, at a glance.
Company profile lookup, form-filtered filing feeds, XBRL concept facts, and catalog discovery — all GET, keyless upstream.
GET/api/v1/sec-filings/company
Company profile
Company profile from SEC submissions. Requires cik or ticker.
GET/api/v1/sec-filings/filings
Filing feed
Recent filings with single/multi-form filtering, sort order, date range, and offset pagination.
GET/api/v1/sec-filings/forms/:formType
Form-specific filings
Filings for a specific form type, e.g. /forms/8-K, with the same date and pagination controls.
GET/api/v1/sec-filings/facts
XBRL concept facts
Company concept facts by taxonomy and tag. Requires cik or ticker plus tag.
GET/api/v1/sec-filings/catalog
Catalog
Capability metadata and example forms.
| Parameter | Type | Required | Description |
|---|---|---|---|
| cik / ticker | string | yes* | Provide one to resolve a company. *One of the two is required. |
| form | string | no | Single form filter for /filings, e.g. 10-K. |
| forms | string | no | Comma-separated form filters for /filings, e.g. 10-K,10-Q,8-K. |
| sort | string | no | desc (default) or asc, by filing date. |
| fromDate / toDate | string | no | Inclusive date bounds, YYYY-MM-DD. |
| limit / offset | integer | no | Filings: 1-100 / 0-2000. Facts: limit 1-40. |
| taxonomy | string | no | XBRL taxonomy for /facts, defaults to us-gaap. |
| tag | string | yes* | XBRL concept tag for /facts, e.g. Assets. *Required for /facts. |
| units | string | no | Preferred unit key in the facts payload, e.g. USD. |
Error reference
Failures you can plan for.
Most errors trace back to an unresolved ticker or a Joi validation failure on query parameters.
400Validation Error
Invalid query parameters, invalid date-range bounds, or a missing cik/ticker/tag.
401Authentication Error
Missing or invalid gateway API key. Send x-api-key or api_key with every request.
404Not Found
Ticker not found in the SEC mapping dataset, or an unknown route.
429Rate Limit Error
More than 180 requests in a 15-minute window per IP.
502Upstream Provider Error
SEC EDGAR request failed or returned invalid JSON.
Example not-found response (404)
{
"success": false,
"error": "Ticker not found in SEC mapping: ZZZZ",
"correlationId": "1784849006651-mgh1kq42p"
}FAQ
API questions developers ask first.
How do I get a company's recent filings?
GET /filings?ticker=AAPL returns recent filings sorted by date. Add form=10-K or forms=10-K,10-Q,8-K to filter, plus fromDate/toDate and limit/offset for pagination.
Is there a route for one specific form type?
Yes. GET /forms/:formType, e.g. /forms/8-K?ticker=MSFT, returns filings for that form type with the same date and pagination controls as /filings.
Can I retrieve XBRL fundamentals data?
Yes. GET /facts?ticker=AAPL&taxonomy=us-gaap&tag=Assets returns concept-level XBRL observations with unit and limit controls.
How do I authenticate requests?
Send your Datpaq API key as an x-api-key header or an api_key query parameter. The upstream SEC EDGAR data itself is keyless, but the Datpaq gateway still requires authentication.
Add SEC EDGAR data in one request.
Company resolution by CIK or ticker, form-filtered filing feeds, and XBRL concept facts, normalized from live SEC EDGAR data.