Skip to content

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

Parameters

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.

Exact form type, such as 10-K. Separate several with commas. Separate several values with commas.

Most filings per page, 1 to 1000.

More parameters (3)

First filing date, YYYY-MM-DD (inclusive).

Last filing date, YYYY-MM-DD (inclusive).

Rows to skip, 0 to 100000000.

Without a key the API answers 401; you can still send the request to see that.
Python
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

NameInTypeRequiredDefaultDescription
cik_or_tickerpathstringyesThe 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.
formquerycomma-separated list of stringnoExact form type, such as 10-K. Separate several with commas.
filed_fromquerydate (YYYY-MM-DD)noFirst filing date, YYYY-MM-DD (inclusive).
filed_toquerydate (YYYY-MM-DD)noLast filing date, YYYY-MM-DD (inclusive).
limitqueryintegerno50Most filings per page, 1 to 1000.
offsetqueryintegerno0Rows 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

StatusBodyDescription
200SecFilingList (application/json)OK
400Problem (application/problem+json)Invalid or unknown parameter.
401Problem (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).
404Problem (application/problem+json)Not found.
503Problem (application/problem+json)Database unavailable; retry after the Retry-After delay.
defaultProblem (application/problem+json)Any other error (405, 500, 504).

Response body

A 200 carries a SecFilingList object.

FieldTypeRequiredDescription
dataarray of SecFilingyes
has_morebooleanno
next_cursorstring | nullnoAlways null: this list pages with offset. Use next_offset.
next_offsetinteger | nullnoThe offset of the next page. Null on the last page, and when the snapshot is unavailable.
offsetintegerno
snapshotSnapshotyes
totalinteger | nullnoRows that match the filters. Null when the snapshot is unavailable.

Example request

Python
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

Python
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())
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