v2 API Reference
Accounts
Lists
Subscribers
Messaging
Message Log (MOMT) Reports
Transactional Messages
Lists
Retrieve List
This endpoint retrieves a specific list.
Copy
Ask AI
curl "https://app.tatango.com/api/v2/lists/<ID>" -X GET \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-u emailaddress@mydomain.com:my_api_key \
-H "Host: example.org" \
-H "Cookie: "
Copy
Ask AI
{
"status": "OK",
"list": {
"id": 2,
"name": "Book Campaign",
"email_digest": "myemail2@gmail.com",
"email_subscribe": null,
"email_unsubscribe": null,
"first_optin_message": "",
"second_optin_message": "",
"message_help": null,
"message_stop": null,
"message_reply": null,
"message_already_subscribed": null,
"message_yes": null,
"keyword_names": [],
"counts": {
"subscribers": 0,
"unsubscribed": 0,
"cleaned": 0
},
"opt_in_type": "single",
"opt_in_requests": []
}
}
Request URL
Copy
Ask AI
GET https://app.tatango.com/api/v2/lists/<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
The ID of the list to retrieve.
Response
200 - application/json
Successful response
The response is of type object
.
Was this page helpful?
Copy
Ask AI
curl "https://app.tatango.com/api/v2/lists/<ID>" -X GET \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-u emailaddress@mydomain.com:my_api_key \
-H "Host: example.org" \
-H "Cookie: "
Copy
Ask AI
{
"status": "OK",
"list": {
"id": 2,
"name": "Book Campaign",
"email_digest": "myemail2@gmail.com",
"email_subscribe": null,
"email_unsubscribe": null,
"first_optin_message": "",
"second_optin_message": "",
"message_help": null,
"message_stop": null,
"message_reply": null,
"message_already_subscribed": null,
"message_yes": null,
"keyword_names": [],
"counts": {
"subscribers": 0,
"unsubscribed": 0,
"cleaned": 0
},
"opt_in_type": "single",
"opt_in_requests": []
}
}
Assistant
Responses are generated using AI and may contain mistakes.