Skip to Content
SendlySendly
API ReferenceEmails

List emails

GET
/api/emails

List emails for the authenticated project. Cursor-paginated for stable scroll over large result sets.

Requires the emails:read scope — View the emails you have sent and their delivery status.

headerAuthorizationBearer <API Key>

API key authentication. Use a sk_* (FULL) or pk_* (SENDING_ONLY) key as the bearer token. Public keys (pk_*) are restricted to the email-send endpoints and the self-serve list subscribe/unsubscribe pair; every other endpoint — event tracking included — answers 403 for them. In scope terms (used by /api/v1/* operations): FULL keys hold every scope; SENDING_ONLY keys hold only emails:send.

limit?integer
Range1 <= value <= 100
Default50
cursor?string
tag?string
status?string

Delivery lifecycle of the message. Engagement is reported separately.

Value in"PENDING""SENDING""SENT""DELIVERED""RECEIVED""BOUNCED""FAILED""REJECTED""RENDERING_FAILURE""DELIVERY_DELAY""CANCELLED"
from?string
complained?"true"

true keeps only emails a recipient reported as spam (Email.complainedAt is set). A complaint does not change status, so it can sit on a SENT or DELIVERED row and no status filter finds it. Combines with status, tag, from, limit and cursor. Any other value answers 400.

Value in"true"

Response Body

Email list

application/json
  1. response

Cursor-paginated list of emails.

success*true
Value intrue
data*array<>
nextCursor?string|null
Example Request
curl -X GET 'https://api.sendly.now/api/emails'
Example Response
{  "success": true,  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "projectId": "5a8591dd-4039-49df-9202-96385ba3eff8",      "from": "string",      "to": "string",      "subject": "string",      "status": "PENDING",      "sentAt": "2019-08-24T14:15:22Z",      "deliveredAt": "2019-08-24T14:15:22Z",      "bouncedAt": "2019-08-24T14:15:22Z",      "openedAt": "2019-08-24T14:15:22Z",      "clickedAt": "2019-08-24T14:15:22Z",      "complainedAt": "2019-08-24T14:15:22Z",      "bounceType": "string",      "bounceSubType": "string",      "bounceDiagnosticCode": "string",      "bounceStatusCode": "string",      "complaintFeedbackType": "string",      "opens": 0,      "clicks": 0,      "tags": [        "string"      ],      "error": "string",      "failureKind": "provider_paused",      "hold": {        "reason": "hourly_ramp_cap",        "message": "string",        "until": "2019-08-24T14:15:22Z"      },      "createdAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z"    }  ],  "nextCursor": "string"}