MailgentMailgent
API Reference

Pagination

How pagination works in the Mailgent API

List endpoints return paginated results using cursor-based pagination.

Parameters

ParamTypeDefaultMaxDescription
limitnumber50100Results per page
pageTokenstring——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.mailgent.dev/v0/messages?limit=10" \
  -H "Authorization: Bearer mgent-your-api-key"

# Next page (use nextPageToken from previous response)
curl "https://api.mailgent.dev/v0/messages?limit=10&pageToken=2026-03-28T09:00:00.000Z" \
  -H "Authorization: Bearer mgent-your-api-key"

Ordering

  • Messages: Newest first (createdAt descending)
  • Threads: Most recently updated first (updatedAt descending)

Get Thread

GET /v0/threads/:threadId

Errors

API error codes and responses

On this page

ParametersResponse FormatExample: Paginating Through All MessagesOrdering