List 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.
AuthorizationBearer <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?integer1 <= value <= 10050cursor?stringtag?stringstatus?stringDelivery lifecycle of the message. Engagement is reported separately.
"PENDING""SENDING""SENT""DELIVERED""RECEIVED""BOUNCED""FAILED""REJECTED""RENDERING_FAILURE""DELIVERY_DELAY""CANCELLED"from?stringcomplained?"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.
"true"Email list
application/json- response
Cursor-paginated list of emails.
success*truetruedata*array<>nextCursor?string|nullcurl -X GET 'https://api.sendly.now/api/emails'{ "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"}