API Reference · Emails

List emails

List recent messages for your workspace, newest first.

GET/v1/messages

Headers

Authorizationstringrequired

Your API key as a bearer token: Bearer rk_your_api_key. You can also use the X-Api-Key header.

Query parameters

limitintegeroptional

Number of messages to return (1–200, default 50).

Request

curl -X GET https://api.raanse.com/v1/messages?limit=50 \
  -H "Authorization: Bearer rk_your_api_key"

Response

200

{
  "success": true,
  "message": "OK",
  "statusCode": 200,
  "data": [
    {
    "id": "01JABCDXYZ0000000000000000",
    "status": "Queued",
    "to": "customer@example.com",
    "fromAddress": "noreply@acme.co",
    "subject": "Welcome to Acme",
    "providerMessageId": null,
    "templateVersionId": null,
    "attempts": 0,
    "createdAt": "2026-07-02T12:00:00Z"
  }
  ]
}