Skip to main content
cURL
curl "https://app.tatango.com/api/v2/lists/ID/messages/MESSAGE_ID" -X GET \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -u [email protected]:my_api_key \
  -H "Host: example.org" \
  -H "Cookie: "
{
  "status": "OK",
  "message": {
    "id": 14523,
    "content": "AMCE Retail: Go to http://bit.ly/acme to see deals on anvils. Reply STOP to end.",
    "sent_at": "2016-09-07T14:10:53-07:00",
    "status": "sent",
    "name": "my message name",
    "is_broadcast": true,
    "recipient_count": 679571,
    "success_count": 675232,
    "bounces_count": 4339,
    "pending_count": 0,
    "clean_count": 2342,
    "unsubscribe_count": 1362,
    "sms_count": 168808,
    "mms_count": 506424,
    "rcs_count": 0,
    "send_cost": 5096.78,
    "attachment": "https://url-to-your-mms-attachment",
    "cancelled_at": null,
    "message_links": [
      {
        "id": 42,
        "link": "http://bit.ly/acme",
        "count": 2356,
        "display_count": 2356
      }
    ],
    "parts": {
      "sum": 679599,
      "minimum": 1,
      "maximum": 2
    }
  }
}
Please note the following:
  • It takes some time after a message is sent to receive delivery status notifications from the various carriers. We recommend waiting until at least 10 minutes after a message is sent to query for delivery statistics.
  • The message_links attribute will only be present on messages that have bit.ly links in their content.
  • The parts attribute will be available 30 minutes after the message was sent.

​
Request URL

GET https://app.tatango.com/api/v2/lists/{ID}/messages/{MESSAGE_ID}

Authorizations

​
Authorization
string
header
required

Tatango authenticates API requests by validating an API key passed via HTTP Basic Authentication. Use your login email as the username and your API key as the password.

Path Parameters

​
ID
integer
required

ID of the list

​
MESSAGE_ID
integer
required

ID of the message

Response

200 - application/json

Successful response

​
status
string
required

Response status

Example:

"OK"

​
message
object
required