Skip to content

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.

JSON
{
  "data": [
    {
      "accession": "…"
    },
    {
      "accession": "…"
    },
    {
      "accession": "…"
    }
  ],
  "has_more": true,
  "next_cursor": "…"
}

Following a cursor

  1. Send the request with your filters and no cursor.
  2. If has_more is true, send the same request again with cursor set to the next_cursor you received.
  3. Stop when has_more is false.
Shell
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:

Python
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 sort and the same order; change none of them between pages.
  • Trust has_more, not the page length. With sort=accepted_at and no cik, a page can hold fewer rows than limit, even none, and still have more: keep following next_cursor until has_more is false. Narrow such a query with accepted_from and accepted_to.
  • Very large filers. For a company with tens of thousands of filings, sort=accepted_at with order=asc can return empty pages while has_more is true, and sort=accession with a cik and another filter can take several seconds or end in a 504 with code timeout. The default sort, filing_date, does not have these limits.
  • A 503 with code snapshot_unavailable on a continuation means the page cannot be produced right now; send the same request again after the Retry-After delay. See Errors.

Page size

RoutelimitDefault
GET /v3/callbacks/deliveriesPage size, 1..100.20
GET /v3/callbacks/endpointsPage size, 1..100 (GET).50
GET /v3/companiesPage size, 1..1000.100
GET /v3/companies/{cik}/segmentsPeriod ends per page, newest first, 1..200 (default 1: the latest fiscal year).1
GET /v3/companies/{cik}/standardPeriod ends per page, newest first, 1..1000.8
GET /v3/companies/{cik}/statementsReports, 1..8 (1 with a category alone).1
GET /v3/entitiesMaximum results, 1..50.20
GET /v3/entities/{cik}/filingsPage size, 1..1000.50
GET /v3/events/8k/{item}Page size, 1..500.50
GET /v3/events/itemsPage size, 1..1000.50
GET /v3/filingsPage size, 1..1000.50
GET /v3/filings/{accession}/13f/holdingsPage size, 1..1000.200
GET /v3/filings/{accession}/factsPage size, 1..5000.1000
GET /v3/filings/{accession}/nportHoldings per page, 1..5000.500
GET /v3/filings/{accession}/parsed/changesPage size, 1..500.100
GET /v3/filings/{accession}/statementsRoles per page, 1..25.25
GET /v3/filings/{accession}/statements/rolesRoles per page, 1..500.500
GET /v3/filings/{accession}/tablesPage size, 1..1000.100
GET /v3/financials/factsPage size, 1..2000.200
GET /v3/financials/framesPage size, 1..50000: rows in CIK, unit and dimension order.500
GET /v3/financials/standardCompanies with a value per page, CIK order, 1..10000.100
GET /v3/funds/holdingsPage size, 1..1000.500
GET /v3/funds/{series_id}/reportsPage size, 1..1000.500
GET /v3/offeringsPage size, 1..1000.500
GET /v3/ownership/insiders/holdingsPage size, 1..500.100
GET /v3/ownership/insiders/transactionsPage size, 1..500.100
GET /v3/ownership/institutional/holdersPage size, 1..1000.200
GET /v3/ownership/institutional/managers/{cik}/holdingsPage size, 1..1000.200
GET /v3/ownership/institutional/managers/{cik}/periodsPage size, 1..200.50
GET /v3/ownership/proposed-salesPage size, 1..200.50
GET /v3/reportsPage size, 1..200.50
GET /v3/searchPage size, 1 to 100.20
GET /v3/search/subscriptionsPage size, 1..100 (GET).50
GET /v3/sectionsPage size, 1..1000.50
GET /v3/streamEvents per answer, 1 to 1000.100

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