v2 API Reference
Accounts
Lists
Subscribers
Messaging
Message Log (MOMT) Reports
Transactional Messages
curl "https://app.tatango.com/api/v2/lists/<ID>/subscribers/<SUBSCRIBER_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",
"subscriber": {
"phone_number": "2065551111",
"cleaned_at": null,
"subscribed_at": "2025-06-18T15:36:07Z",
"opted_out_at": null,
"opt_in_method": "keyword",
"keyword_name": "JOIN",
"carrier": 383,
"carrier_name": "Verizon Wireless",
"global_carrier_id": "12345",
"global_carrier_name": "Verizon",
"total_messages_received": 15
}
}Getting a Subscriber
This endpoint returns information about a current subscriber.
curl "https://app.tatango.com/api/v2/lists/<ID>/subscribers/<SUBSCRIBER_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",
"subscriber": {
"phone_number": "2065551111",
"cleaned_at": null,
"subscribed_at": "2025-06-18T15:36:07Z",
"opted_out_at": null,
"opt_in_method": "keyword",
"keyword_name": "JOIN",
"carrier": 383,
"carrier_name": "Verizon Wireless",
"global_carrier_id": "12345",
"global_carrier_name": "Verizon",
"total_messages_received": 15
}
}Request URL
GET https://app.tatango.com/api/v2/lists/{ID}/subscribers/{SUBSCRIBER_ID}
Authorizations
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 of the list
ID of the subscriber (phone number)
Response
Successful response
"OK"
Show child attributes
Show child attributes
The wireless phone number of the subscriber
"2141234567"
Date subscriber first subscribed to this list
"2025-06-18T15:36:07Z"
Original opt-in method used
"api"
First name of the subscriber
"John"
Last name of the subscriber
"Doe"
Email address of the subscriber
Birthdate of the subscriber
"19900101"
ZIP code of the subscriber
"75201"
Gender of the subscriber
"Male"
Date/time of automatic unsubscription (if applicable)
Date subscriber last unsubscribed from this list
Keyword used for opt-in (if applicable)
Wireless carrier ID
383
Wireless carrier name
"Verizon Wireless"
Global wireless carrier ID
"12345"
Global wireless carrier name
"Verizon"
List of tags associated with the subscriber
["vip", "customer"]The total amount of mass messages this specific subscriber has received over their lifetime from this specific list
15
Was this page helpful?