curl "https://app.tatango.com/api/v2/lists/<ID>/messages" -d '{"start_date":"20160901", "end_date":"20161030"}' -X GET \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -u emailaddress@mydomain.com:my_api_key \
    -H "Host: example.org" \
    -H "Cookie: "
{
  "status": "OK",
  "per_page": 10,
  "count": 2,
  "page": 1,
  "pages_count": 1,
  "messages": [
    {
      "id": 14523,
      "content": "AMCE Retail: Save $20 off this weekend when you spend more than $100 in-store. Show this text message to redeem. Reply STOP to end.",
      "status": "sent",
      "sent_at": "2016-09-07T14:10:53-07:00",
      "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,
      "send_cost": 5096.78,
      "cancelled_at": null,
      "parts": {
        "sum": 679599,
        "minimum": 1,
        "maximum": 2
      }
    }
  ]
}

​
Request URL

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

Please note the following:

  • The message_links attribute will only be present on messages that have bit.ly links in their content.
  • The tracking_links attribute will only be present on messages that have tracking links in their content.
  • The parts attribute will be available 30 minutes after the message was sent.

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

The ID of the list

Query Parameters

​
start_date
string

A date in YYYYMMDD format. Messages sent before this date will not be returned (UTC).

​
end_date
string

A date in YYYYMMDD format. Messages sent after this date will not be returned (UTC).

Response

200 - application/json

Successful response

The response is of type object.