WoyraDocs
Get an API key

Retrieve a received email

GET/v1/emails/inbound/{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/inbound/email_01J... \
  -H "Authorization: Bearer $WOYRA_KEY"

Response

200 The email, with its text, HTML, headers, verdicts and attachment list.

FieldTypeDescription
object"inbound_email"
idstring
domainstringThe verified domain that received it.
fromstringThe sender's address
tostringThe address on your domain it was delivered to.
recipientsarray of stringEveryone on To and Cc, as written.
subjectstring
textstringThe plain-text body
htmlstringThe HTML body
in_reply_tostringThe id of the email you sent that this replies to, when the reply headers name one.
thread_idstringThe conversation this belongs to: the reply-to email's thread, or this email's own id when it starts one.
message_idstringThe sender's own Message-ID
headersobject
verdictsobjectWhat the receiving provider concluded, each PASS, FAIL, GRAY or PROCESSING_FAILED.
verdicts.spfstring
verdicts.dkimstring
verdicts.dmarcstring
verdicts.spamstring
verdicts.virusstring
size_bytesinteger
attachmentsarray of InboundAttachment
received_attimestamp
created_attimestamp

Errors

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

Also in Emails