Skip to main content
GET
/
api
/
v2
/
lists
/
{ID}
/
messages
/
draft
cURL
curl "https://app.tatango.com/api/v2/lists/<ID>/messages/draft" -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.",
      "sent_at": "2016-09-07T14:10:53-07:00",
      "status": "draft",
      "name": "my message name",
      "is_broadcast": false,
      "recipient_count": 0,
      "success_count": 0,
      "bounces_count": 0,
      "pending_count": 0,
      "clean_count": 0,
      "unsubscribe_count": 0,
      "sms_count": 0,
      "mms_count": 0,
      "send_cost": 0,
      "attachment": "https://url-to-your-mms-attachment"
    }
  ]
}

​
Request URL

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

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. Drafts created before this date will not be returned (UTC).

​
end_date
string

A date in YYYYMMDD format. Drafts created 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