Pagination
Lists come in one envelope. Certain routes page with a keyset cursor and return no total count. One request returns a full page: GET /v3/filings returns 50 rows by default, and up to 1000 with limit; each route's reference page gives its own default and maximum. Follow next_cursor to go on.
{
"data": [
{
"accession": "…"
},
{
"accession": "…"
},
{
"accession": "…"
}
],
"has_more": true,
"next_cursor": "…"
}Following a cursor
- Send the request with your filters and no
cursor. - If
has_moreis true, send the same request again withcursorset to thenext_cursoryou received. - Stop when
has_moreis false.
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
'https://api.secblast.com/v3/filings?form=10-K&limit=200'
curl -sS -H "Authorization: Bearer $SECBLAST_API_KEY" \
'https://api.secblast.com/v3/filings?form=10-K&limit=200&cursor=NEXT_CURSOR_FROM_THE_PREVIOUS_PAGE'In Python, continuing the quickstart session:
params = {"form": "10-K", "filed_from": "2026-09-01", "filed_to": "2026-09-30", "limit": 200}
while True:
r = session.get(f"{API}/filings", params=params, timeout=30)
r.raise_for_status()
page = r.json()
for filing in page["data"]:
handle(filing)
if not page["has_more"]:
break
# Same filters, same sort and order; only the cursor changes.
params["cursor"] = page["next_cursor"]Rules
- A cursor is opaque. Pass back exactly what you received.
- A cursor belongs to its query. Use it with the same filters, the same
sortand the sameorder; change none of them between pages. - Trust
has_more, not the page length. Withsort=accepted_atand nocik, a page can hold fewer rows thanlimit, even none, and still have more: keep followingnext_cursoruntilhas_moreis false. Narrow such a query withaccepted_fromandaccepted_to. - Very large filers. For a company with tens of thousands of filings,
sort=accepted_atwithorder=asccan return empty pages whilehas_moreis true, andsort=accessionwith acikand another filter can take several seconds or end in a504with codetimeout. The default sort,filing_date, does not have these limits. - A 503 with code
snapshot_unavailableon a continuation means the page cannot be produced right now; send the same request again after theRetry-Afterdelay. See Errors.
Page size
The one offset-paged list
GET /v3/entities/{cik}/filings and GET /v3/filings/{accession}/items/{code}/text and GET /v3/filings/{accession}/sections/{section}/text are the SEC's own filing lists for an entity and are paged with offset, not a cursor: pass the response's next_offset back as offset until it is null. Its next_cursor is always null. The list can shift when a new snapshot is loaded.
Other lists
The remaining lists use the same envelope and take no cursor.
Markdown version: /docs/pagination.md