SDK / API Reference
Pagination
How pagination works in the Loomal API
List endpoints return paginated results using cursor-based pagination.
Parameters
| Param | Type | Default | Max | Description |
|---|---|---|---|---|
limit | number | 50 | 100 | Results per page |
pageToken | string | — | — | Cursor from previous response |
Response Format
{
"messages": [...],
"count": 50,
"nextPageToken": "2026-03-28T09:00:00.000Z"
}If nextPageToken is present, there are more results. Pass it as pageToken in the next request.
Example: Paginating Through All Messages
# First page
curl "https://api.loomal.ai/v0/messages?limit=10" \
-H "Authorization: Bearer loid-your-api-key"
# Next page (use nextPageToken from previous response)
curl "https://api.loomal.ai/v0/messages?limit=10&pageToken=2026-03-28T09:00:00.000Z" \
-H "Authorization: Bearer loid-your-api-key"Ordering
- Messages: Newest first (
createdAtdescending) - Threads: Most recently updated first (
updatedAtdescending)
Endpoint Support
| Endpoint | Pagination | Notes |
|---|---|---|
GET /v0/messages | limit, pageToken | Cursor-based, default 50 |
GET /v0/threads | limit, pageToken | Cursor-based, default 50 |
GET /v0/logs | limit | Limit only, default 50 |
GET /v0/vault | None | Returns all credentials |
GET /v0/calendar | limit, from, to | Date-range filters, not cursor-based |