List emails

List the emails your account sent through the API, newest first.

GEThttps://api.cresca.xyz/api/v1/emails

Requires a full-access key. List items leave out html and text; retrieve an email to get its body.

Query parameters

limitnumberoptional

Number of emails to return, 1 to 100. Default 20.

afterstringoptional

An email id. Returns emails older than it (the next page).

beforestringoptional

An email id. Returns emails newer than it (the previous page). Use after or before, not both.

Example

Request

curl -X GET 'https://api.cresca.xyz/api/v1/emails?limit=2' \
  -H 'Authorization: Bearer cr_live_xxxxxxxxx'

Response 200

{
  "object": "list",
  "has_more": true,
  "data": [
    {
      "object": "email",
      "id": "4ef9a417-02e9-4d39-ad75-9611e0fcc33c",
      "from": "Acme <hello@acme.com>",
      "to": [
        "user@example.com"
      ],
      "cc": null,
      "bcc": null,
      "reply_to": null,
      "subject": "Reset your password",
      "created_at": "2026-10-19T09:14:03.120Z",
      "scheduled_at": null,
      "last_event": "delivered",
      "tags": []
    },
    {
      "object": "email",
      "id": "b6d1f2a0-5e2f-4c8e-9a51-0c8b5f1d2e33",
      "from": "Acme <hello@acme.com>",
      "to": [
        "ana@example.com"
      ],
      "cc": null,
      "bcc": null,
      "reply_to": null,
      "subject": "Your order #1042 is confirmed",
      "created_at": "2026-10-19T09:02:41.006Z",
      "scheduled_at": null,
      "last_event": "sent",
      "tags": [
        {
          "name": "category",
          "value": "order"
        }
      ]
    }
  ]
}

To get the next page, pass the id of the last item as after, while has_more is true.