/messages/voice/{voice_id}/recipients/could_not_connect

Secured By: Authentication Token
Description:

View only those recipients who could not be reached.

Responses with more than 50 records will be paginated to 50 records per response, unless otherwise specified.

Headers

Name Required Type Description
X-AUTH-TOKEN * string

An authentication token provided to you by GovDelivery.

Status

Headers

Name Type Description
Link string

Appropriate pagination link relations. Can include "first", "last", "prev", and "next" relations.

Example

< /messages/voice/{voice_id}/recipients/could_not_connect?page=1>; rel="first",
< /messages/voice/{voice_id}/recipients/could_not_connect?page=2>; rel="prev",
< /messages/voice/{voice_id}/recipients/could_not_connect?page=4>; rel="next",
< /messages/voice/{voice_id}/recipients/could_not_connect?page=5>; rel="last"

Body

Format: application/json

Schema
Array of objects that may include:
Name Type Description
phone string

The phone number provided in the initial API call.

Example

6515551000
formatted_phone string

The phone number converted to E.164 format. This is the value passed to the SMS provider.

Example

+16515551000
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 message has a status of 4, this will be the reason that the SMS 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 voice Recipient.

Example

{
  "self": "/messages/voice/10507/recipients/364898",
  "voice_message": "/messages/voice/10507"
}
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "title": "Voice Recipients",
  "description": "A list of recipients of a voice message",
  "type": "array",
  "items": {
    "title": "Voice Recipient",
    "description": "Get information about a voice recipient",
    "properties": {
      "phone": {
        "description": "The phone number provided in the initial API call.",
        "type": "string",
        "example": "6515551000"
      },
      "formatted_phone": {
        "description": "The phone number converted to E.164 format.  This is the value passed to the SMS provider. ",
        "type": "string",
        "example": "+16515551000"
      },
      "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 message has a status of 4, this will be the reason that the SMS 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 voice Recipient.",
        "type": "object",
        "example": "{\n\"self\": \"/messages/voice/10507/recipients/364898\",\n\"voice_message\": \"/messages/voice/10507\"\n}"
      }
    }
  }
}

Body

Format: application/json

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