WoyraDocs
Get an API key

Retrieve an email

GET/v1/emails/{id}

Emails · Requires an API key

Parameters

NameInDescription
idrequiredpath
Woyra-VersionheaderThe dated API version to serve. Omit to pin to the oldest supported version.

Example

curl https://api.woyra.io/v1/emails/email_01J... \
  -H "Authorization: Bearer $WOYRA_KEY"

Response

200 The email, including its route decision once dispatched.

FieldTypeDescription
objectrequired"email"
idrequiredstring
statusrequiredstring
One of accepted, scheduled, queued, sent, delivered, undelivered, failed, suppressed, canceled.
torequiredstringThe one address this copy went to.
fromrequiredstring
subjectrequiredstring
created_atrequiredtimestamp
scheduled_attimestampWhen a scheduled email leaves. Absent once it has.
recipientsarray of objectOn the answer to a send with more than one recipient: one copy per person, each its own email with its own id, status and webhooks. The first is this email.
recipients.tostring
recipients.idstring
recipients.statusstring
eventsarray of EmailEventOn GET /v1/emails/{id}: every status the email has had, oldest first, so a support ticket can be answered from one request.
metadataobject
thread_idstringThe conversation this email belongs to, readable at /v1/emails/threads/{thread_id}.
in_reply_tostringThe email this one answers, when it was sent as a reply.
routeRouteDecisionWhich carrier carried this message, why it was chosen, and what it cost. No other provider shows this.
errorErrorSummaryThe canonical failure reason, normalised across every carrier.

Errors

StatusCodes
401authentication_required, invalid_api_key
403insufficient_scope, domain_not_verified, recipient_suppressed, sending_paused, mfa_required
404not_found, product_not_offered

Also in Emails