Small surface.
Useful data.
Send Authorization: Bearer YOUR_API_KEY with every request. Responses are JSON, with data and source metadata. Use the OpenAPI specification for machine-readable endpoint definitions.
Company search
GET /api/v1/companies?query=AAPLSearch the SEC ticker directory by company name or ticker.
| PARAMETER | DESCRIPTION |
|---|---|
query | Search term, such as AAPL or Apple. |
limit | Maximum results. Default 20; maximum 100. |
Company profile
GET /api/v1/companies/320193Retrieve company identity information for a CIK. Both short and zero-padded CIKs are accepted.
Company filings
GET /api/v1/filings?cik=320193&form=10-K&limit=25Retrieve company filing metadata with references to original SEC documents. Results come from the recent company submissions data; this is not a full-text search endpoint or a complete historical archive. Inspect meta.historyCoverage in the response.
| PARAMETER | DESCRIPTION |
|---|---|
cik | Required company identifier. |
form | Optional form filter, such as 10-K, 10-Q, or 8-K. |
limit | Page size. Default 25; maximum 100. |
offset | Pagination offset. Default 0. |
XBRL company facts
GET /api/v1/facts/320193?taxonomy=us-gaap&concept=Assets&unit=USDAccess reported XBRL facts from SEC company facts. Keep unit, reporting-period, and filing context with every value. Different reporting contexts can produce several values for the same concept.
| PARAMETER | DESCRIPTION |
|---|---|
cik (path) | Required company identifier. |
taxonomy | Optional taxonomy filter, such as us-gaap. |
concept | Optional concept, such as Assets or Revenues. |
unit | Optional unit filter, such as USD. |
limit | Page size. Default 100; maximum 500. |
offset | Pagination offset. Default 0. |
Response metadata
Responses wrap their payload in data. Metadata includes the source, fetch time, request ID, and a stale indicator. Paginated endpoints include pagination with the offset, limit, total, and next offset where applicable.
{
"data": [],
"meta": {
"source": "SEC source URL",
"fetchedAt": "ISO 8601 timestamp",
"stale": false,
"requestId": "request identifier"
}
}This is an illustrative envelope, not a live response. Run a real request in the playground.
Errors and usage limits
Inspect the HTTP status before processing data. Errors use error.code, error.message, and error.requestId; retry guidance may be included for rate limits.
| PARAMETER | DESCRIPTION |
|---|---|
400 | Invalid or missing request parameters. |
401 | Missing or invalid API authentication. |
404 | The requested resource was not found. |
429 | Request rate or usage allowance exceeded. Respect retry guidance. |
5xx | Service or upstream request failure. Retry with bounded exponential backoff. |
Cache responses where appropriate for your application and avoid retry loops. Free accounts include 1,000 monthly requests. Paid plans provide larger allowances; see pricing.