Pagination
page and limit query parameters.Query Parameters
| Parameter | Type | Default | Max | Description |
|---|---|---|---|---|
page | integer | 1 | — | Page number, 1-indexed |
limit | integer | 20 | 100 | Number of results per page |
Request
Response
{
"status": 200,
"data": {
"items": [
{ "id": "mbx_051", "email": "alice@mycoldoutreach.com", "status": "ACTIVE" },
{ "id": "mbx_052", "email": "alice1@mycoldoutreach.com", "status": "ACTIVE" }
],
"pagination": {
"page": 2,
"limit": 50,
"total": 84,
"totalPages": 2
}
}
}| Field | Description |
|---|---|
pagination.page | Current page number |
pagination.limit | Results per page used for this response |
pagination.total | Total number of records across all pages |
pagination.totalPages | Total number of pages at the current limit |
Iterating All Pages
Fetch the first page
Start with
page=1 and your preferred limit. Read pagination.totalPages from the response to know how many pages exist.Loop through remaining pages
Continue until
page > pagination.totalPages.Respect rate limits between pages
If iterating many pages in a tight loop, add a small delay between requests to stay under the 5 req/sec limit.
TIP
limit=100 when fetching all pages to minimize the number of requests. The default is 20, which means 5× more requests for the same data.Paginated Endpoints
| Endpoint | Description |
|---|---|
GET /users/list | All users under your partner account |
GET /mailboxes | All mailboxes for a user |
GET /subscriptions | All subscriptions for a user |
GET /exports/platform-exports | Export history for a user |
GET /exports/platform-credentials | Stored platform credentials for a user |
Next Steps
Modified at 2026-08-05 16:12:50