# 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](https://www.secblast.com/docs/authentication).

**Group:** [Entities](https://www.secblast.com/docs/reference#entities)

## Try it

Send this route from the page, signed in with your key, or from the [console](https://www.secblast.com/console).

## 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](https://www.secblast.com/docs/reference/schemas#schema-secfilinglist) (`application/json`) | OK |
| `400` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Invalid or unknown parameter. |
| `401` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-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](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Not found. |
| `503` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Database unavailable; retry after the Retry-After delay. |
| `default` | [Problem](https://www.secblast.com/docs/reference/schemas#schema-problem) (`application/problem+json`) | Any other error (405, 500, 504). |

## Response body

A `200` carries a [SecFilingList](https://www.secblast.com/docs/reference/schemas#schema-secfilinglist) object.

| Field | Type | Required | Description |
|---|---|---|---|
| `data` | array of [SecFiling](https://www.secblast.com/docs/reference/schemas#schema-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](https://www.secblast.com/docs/reference/schemas#schema-snapshot) | yes |   |
| `total` | integer \| null | no | Rows 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}`](https://www.secblast.com/docs/reference/get-entities-cik-or-ticker) · Next: [`GET /v3/resolve`](https://www.secblast.com/docs/reference/get-resolve)
