List emails
GET/v1/emails
Returns emails newest first. Pagination is cursor-based: pass the next_cursor of one page as the cursor of the next. Because every Woyra ID is time-sortable, the cursor is simply the last ID of the previous page.
Parameters
| Name | In | Description |
|---|---|---|
| limit | query | |
| cursor | query | The next_cursor from the previous page. |
| Woyra-Version | header | The dated API version to serve. Omit to pin to the oldest supported version. |
Example
curl https://api.woyra.io/v1/emails \
-H "Authorization: Bearer $WOYRA_KEY"Response
200 A page of emails.
| Field | Type | Description |
|---|---|---|
| objectrequired | "list" | |
| datarequired | array of Email | |
| has_morerequired | boolean | |
| next_cursor | string |
Errors
| Status | Codes |
|---|---|
| 400 | invalid_request, unsupported_version |
| 401 | authentication_required, invalid_api_key |
| 403 | insufficient_scope, domain_not_verified, recipient_suppressed, sending_paused, mfa_required |
Also in Emails
- POST /v1/emails — Send an email
- GET /v1/emails/{id} — Retrieve an email
- POST /v1/emails/{id}/cancel — Cancel a scheduled email
- POST /v1/emails/batch — Send a batch of emails
- GET /v1/templates — List templates
- POST /v1/templates — Save an email template
- GET /v1/templates/{id} — Retrieve a template
- PATCH /v1/templates/{id} — Change a template
- DELETE /v1/templates/{id} — Delete a template
- GET /t/o/{token} — Open tracking image
- GET /t/c/{token} — Click tracking redirect
- GET /v1/emails/inbound — Mail received on your domains
- GET /v1/emails/inbound/{id} — Retrieve a received email
- GET /v1/emails/inbound/{id}/attachments/{attachment_id} — Download an attachment
- GET /v1/emails/threads/{id} — A conversation