/messages/email/{email_id}/recipients/{id}

Secured By: Authentication Token
Description:

View only the specified recipient.

Headers

Name Required Type Description
X-AUTH-TOKEN * string

An authentication token provided to you by GovDelivery.

Status

Body

Format: application/json

Schema
Object that may include:
Name Type Description
email string

The email address provided in the initial API call.

Example

test01@test.govdelivery.com
macros object

List of macros with values used for the recipient

Example

{
  "city": "RECIPIENT Saint Paul",
  "address": "RECIPIENT 408 Saint Peter Street",
  "company": "RECIPIENT GovDelivery",
  "url": "RECIPIENT www.govdelivery.com"
}
status string

The status of the message send to the recipient.

  • ‘new’ - The recipient has not been sent.
  • ‘sending’ - The recipient has been sent, but no delivery information has been obtained.
  • ‘sent’ - The recipient has been confirmed as sent.
  • ‘failed’ - The recipient has been confirmed as failed.
  • ‘blacklisted’ - The recipient is on the blacklist (not yet implemented for Email).

Valid Values:

  • new
  • sending
  • sent
  • failed
  • blacklisted
error_message string

When a recipient has a status of ‘failed’, this will be the reason that the email provider rejected the recipient.
created_at string

The date and time when the recipient was created.

Example

2013-03-15T21:10:30Z
completed_at string
The date and time that the recipient entered a final state (sent failed blacklisted).

Example

2013-03-15T21:11:02Z
_links object

Link relations available for the Email Recipient.

Example

{
  "self": "/messages/email/10507/recipients/364898",
  "email_message": "/messages/email/10507",
  "opens": "/messages/email/10507/recipients/364898/opens",
  "clicks": "/messages/email/10507/recipients/364898/clicks"
}
 
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "title": "Email Recipient",
  "description": "Get information about an email recipient",
  "properties": {
    "email": {
      "description": "The email address provided in the initial API call.",
      "type": "string",
      "example": "test01@test.govdelivery.com"
    },
    "macros": {
      "description": "List of macros with values used for the recipient",
      "type": "object",
      "example": "{\"city\":\"RECIPIENT Saint Paul\",\"address\":\"RECIPIENT 408 Saint Peter Street\",\"company\":\"RECIPIENT GovDelivery\",\"url\":\"RECIPIENT www.govdelivery.com\"}"
    },
    "status": {
      "description": "The status of the message send to the recipient.\n\n- 'new' - The recipient has not been sent.\n- 'sending' - The recipient has been sent, but no delivery information has been obtained.\n- 'sent' - The recipient has been confirmed as sent.\n- 'failed' - The recipient has been confirmed as failed.\n- 'blacklisted' - The recipient is on the blacklist (not yet implemented for Email).",
      "type": "string",
      "enum": [
        "new",
        "sending",
        "sent",
        "failed",
        "blacklisted"
      ]
    },
    "error_message": {
      "description": "When a recipient has a status of 'failed', this will be the reason that the email provider rejected the recipient.",
      "type": "string"
    },
    "created_at": {
      "description": "The date and time when the recipient was created. ",
      "type": "string",
      "example": "2013-03-15T21:10:30Z"
    },
    "completed_at": {
      "description": "The date and time that the recipient entered a final state (sent|failed|blacklisted). ",
      "type": "string",
      "example": "2013-03-15T21:11:02Z"
    },
    "_links": {
      "description": "Link relations available for the Email Recipient.",
      "type": "object",
      "example": "{\n\"self\": \"/messages/email/10507/recipients/364898\",\n\"email_message\": \"/messages/email/10507\",\n\"opens\": \"/messages/email/10507/recipients/364898/opens\",\n\"clicks\": \"/messages/email/10507/recipients/364898/clicks\"\n}"
    }
  }
}

Body

Format: application/json

Example
{
  "error": "Invalid authentication token"
}