Pagination

OverviewLink to section

Mixedbread API uses cursor-based pagination for endpoints that return large result sets. This approach provides consistent performance regardless of dataset size and ensures reliable pagination even when data is being modified.

Supported EndpointsLink to section

Cursor-based pagination is used for:

• List Stores
• List Files
• List Parsing Jobs

Pagination ParametersLink to section

Request ParametersLink to section

Include these query parameters in your requests:

Important Notes:

• Use either before OR after, not both
• Cursors are opaque strings - don't parse or modify them
• Always include limit to control result size

Response FormatLink to section

All paginated responses include:

{
  "data": [...],
  "pagination": {
    "first_cursor": "eyJpZCI6InZzXzEyMyJ9",
    "last_cursor": "eyJpZCI6InZzXzQ1NiJ9", 
    "has_more": true
  }
}

Navigation PatternsLink to section

Forward PaginationLink to section

Start with no cursor to get the first page:

GET /v1/stores?limit=10

Continue with last_cursor from the previous response:

GET /v1/stores?after=eyJpZCI6InZzXzQ1NiJ9&limit=10

Backward PaginationLink to section

Use first_cursor with before parameter:

GET /v1/stores?before=eyJpZCI6InZzXzEyMyJ9&limit=10