/messages/voice/{voice_id}/recipients/human

Secured By: Authentication Token
Description:

View only those recipients who were human.

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/human?page=1>; rel="first",
< /messages/voice/{voice_id}/recipients/human?page=2>; rel="prev",
< /messages/voice/{voice_id}/recipients/human?page=4>; rel="next",
< /messages/voice/{voice_id}/recipients/human?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"
}