GET /v3/entities/{cik_or_ticker}/filings
List SEC's filings for a company, newest first.
This is SEC's own list, from its submissions snapshot. Each row says whether SEC Blast has the filing. The answer is 404 when the snapshot has no such CIK. When the snapshot store is unavailable, data is empty and snapshot.available is false.
This is SEC's own filing list for the company, updated nightly, so it runs about a day behind. For filings as they arrive, use GET /v3/filings with cik.
API key: required. See Authentication.
Group: Entities
Try it
import os
import requests
r = requests.get(
"https://api.secblast.com/v3/entities/AAPL/filings",
params={"form": "10-K", "limit": "2"},
headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
timeout=30,
)
r.raise_for_status()
print(r.json())Response
Nothing has been sent yet.
Parameters
| Name | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
cik_or_ticker | path | string | yes | The company's CIK, such as 320193, or its ticker, such as AAPL. Leading zeros are optional. A ticker is looked up in SEC's ticker file, in any letter case. An unknown ticker is a 400 unknown_ticker error. The resolved member gives the CIK. | |
form | query | comma-separated list of string | no | Exact form type, such as 10-K. Separate several with commas. | |
filed_from | query | date (YYYY-MM-DD) | no | First filing date, YYYY-MM-DD (inclusive). | |
filed_to | query | date (YYYY-MM-DD) | no | Last filing date, YYYY-MM-DD (inclusive). | |
limit | query | integer | no | 50 | Most filings per page, 1 to 1000. |
offset | query | integer | no | 0 | Rows to skip, 0 to 100000000. |
Details
Paging: pass next_offset back as offset; next_cursor is always null. The list can shift when a new snapshot loads.
Responses
| Status | Body | Description |
|---|---|---|
200 | SecFilingList (application/json) | OK |
400 | Problem (application/problem+json) | Invalid or unknown parameter. |
401 | Problem (application/problem+json) | Missing, invalid, or inactive API key (code unauthorized), or a refused access token (code invalid_token: malformed, unknown key, bad signature, expired, wrong issuer or audience, revoked grant). WWW-Authenticate names the protected-resource metadata (RFC 9728). |
404 | Problem (application/problem+json) | Not found. |
503 | Problem (application/problem+json) | Database unavailable; retry after the Retry-After delay. |
default | Problem (application/problem+json) | Any other error (405, 500, 504). |
Response body
A 200 carries a SecFilingList object.
| Field | Type | Required | Description |
|---|---|---|---|
data | array of SecFiling | yes | |
has_more | boolean | no | |
next_cursor | string | null | no | Always null: this list pages with offset. Use next_offset. |
next_offset | integer | null | no | The offset of the next page. Null on the last page, and when the snapshot is unavailable. |
offset | integer | no | |
snapshot | Snapshot | yes | |
total | integer | null | no | Rows that match the filters. Null when the snapshot is unavailable. |
Example request
import os
import requests
r = requests.get(
"https://api.secblast.com/v3/entities/AAPL/filings",
headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
timeout=30,
)
r.raise_for_status()
print(r.json())Example answer
import os
import requests
r = requests.get(
"https://api.secblast.com/v3/entities/AAPL/filings",
params={"form": "10-K", "limit": "2"},
headers={"Authorization": f"Bearer {os.environ['SECBLAST_API_KEY']}"},
timeout=30,
)
r.raise_for_status()
print(r.json()){
"data": [
{
"accepted_at": "2026-11-03T13:05:15Z",
"accession": "0000320193-26-000026",
"act": "34",
"cik": "0000320193",
"file_number": "001-36743",
"filing_date": "2026-11-03",
"film_number": "261514222",
"form": "10-K",
"in_v3": true,
"is_inline_xbrl": true,
"is_xbrl": true,
"items": [],
"links": {
"filing": "/v3/filings/0000320193-26-000026"
},
"primary_doc_description": "10-K",
"primary_document": "aapl-20260926.htm",
"report_date": "2026-09-26",
"size": 10902198,
"status": "final"
},
{
"accepted_at": "2025-10-31T10:01:26Z",
"accession": "0000320193-25-000079",
"act": "34",
"cik": "0000320193",
"file_number": "001-36743",
"filing_date": "2025-10-31",
"film_number": "251437791",
"form": "10-K",
"in_v3": true,
"is_inline_xbrl": true,
"is_xbrl": true,
"items": [],
"links": {
"filing": "/v3/filings/0000320193-25-000079"
},
"primary_doc_description": "10-K",
"primary_document": "aapl-20250927.htm",
"report_date": "2025-09-27",
"size": 9392337,
"status": "final"
}
],
"has_more": true,
"next_cursor": null,
"next_offset": 2,
"offset": 0,
"snapshot": {
"available": true,
"date": "2026-11-18"
},
"total": 31,
"resolved": {
"cik": "0000320193",
"ticker": "AAPL",
"ticker_file_date": "2026-11-18"
}
}More in Entities
Previous: GET /v3/entities/{cik_or_ticker} · Next: GET /v3/resolve
Markdown version: /docs/reference/get-entities-cik-or-ticker-filings.md