/
Retrieve an email message

Retrieve an email message

Request

Retrieves an email message with a specified ID.

Security
SecretApiKey or JWT
Path
idstring, <= 50 characters^[@~\-\.\w]+$required

ID of the resource.

curl -i -X GET \
  'https://www.rebilly.com/_mock/catalog/all/email-messages/{id}' \
  -H 'REB-APIKEY: YOUR_API_KEY_HERE'

Responses

Email message retrieved.

Bodyapplication/json
idstring, <= 50 charactersread-only

ID of the email message.

Example:"mail_msg_0YVCNR8ZRBCVMAX28DP4XRFZVA"
statusstring

Status of the email message.

Default:"draft"
Enum:"draft""outbox""sent""failed"
metadataobject or null

Metadata associated with the email message.

Example:
{
  "eventType": "subscription-canceled"
}
credentialHashstring or null

ID of the SMTP or Email Service Provider (ESP) credential.

Example:"b120c2ca-6c2b-4690-9dff-3b0d87852dc7"
fromstring, (email), <= 254 charactersrequired

Email address of the sender.

Example:"from-example@rebilly.com"
toArray of strings, non-emptyrequired

List of email addresses to which the email message is sent.

Example:
[
  "to-example@rebilly.com"
]
ccArray of strings

List of CC email addresses to which the email message is sent.

Example:
[
  "cc-example@rebilly.com"
]
bccArray of strings

List of BCC email addresses to which the email message is sent.

Example:
[
  "cc-example@rebilly.com"
]
subjectstring, <= 998 charactersrequired

Subject of the email message.

Example:"Welcome dear customer!"
textstringrequired

Body of the email message in plain text.

Example:"Email message text body"
htmlstringrequired

Body of the email message in HTML format.

Example:"<p>Email message html body</p>"
attachmentsArray of objects

Attachments of the email message.

responseCodeinteger or nullread-only

Status code returned by a mail service after an attempt to send email.

Example:250
responseBodystring or nullread-only

Body of response returned by a mail service after an attempt to send email.

initiatedTimestring or null, (date-time)read-only

Date and time when the email is initiated.

sentTimestring or null, (date-time)read-only

Date and time when the email is sent.

createdTimestring, (date-time)(CreatedTime)read-only

Date and time when the resource is created. This value is set automatically when the resource is created.

updatedTimestring, (date-time)(UpdatedTime)read-only

Date and time when the resource is updated. This value is set automatically when the resource is updated.

Response
{
  "id": "mail_msg_0YVCNR8ZRBCVMAX28DP4XRFZVA",
  "status": "draft",
  "metadata": {
    "eventType": "subscription-canceled"
  },
  "credentialHash": "b120c2ca-6c2b-4690-9dff-3b0d87852dc7",
  "from": "from-example@rebilly.com",
  "to": [
    "to-example@rebilly.com"
  ],
  "cc": [
    "cc-example@rebilly.com"
  ],
  "bcc": [
    "cc-example@rebilly.com"
  ],
  "subject": "Welcome dear customer!",
  "text": "Email message text body",
  "html": "<p>Email message html body</p>",
  "attachments": [
    { … }
  ],
  "responseCode": 250,
  "responseBody": "string",
  "initiatedTime": "2019-08-24T14:15:22Z",
  "sentTime": "2019-08-24T14:15:22Z",
  "createdTime": "2019-08-24T14:15:22Z",
  "updatedTime": "2019-08-24T14:15:22Z",
  "_links": [
    { … }
  ]
}