Pagination and Filtering

Cursor pagination

Paginated list endpoints use Relay-style cursor pagination instead of offset-based pagination. A cursor represents a specific position in a list.

To page forward:

1. Send the first request with first set to the page size.
2. Read the cursor of the last item in the response.
3. Send the next request with after set to that cursor.
4. Stop when pageInfo shows no next page.

To page backward, use last and before. You cannot combine forward and backward parameters in the same request.

Page size

The default page size is 100 items. The maximum page size is 500 items.

Response shape

Paged responses contain three fields:

Filtering

Filtering is typically specified using query parameters. See specific resource endpoints to see the available options:

• List all mail items
• List all of a company's filings