Skip to main content
GET
/
api
/
v2
/
lists
/
{ID}
/
messages
cURL
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 [email protected]: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

​
status
string
required
Example:

"OK"

​
per_page
integer
required

Number of items per page

Example:

10

​
count
integer
required

Number of messages returned

Example:

2

​
page
integer
required

Current page number

Example:

1

​
pages_count
integer
required

Total number of pages

Example:

1

​
messages
object[]
required