curl "https://app.tatango.com/api/v2/lists" -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": 3,
"page": 1,
"pages_count": 1,
"lists": [
{
"id": 7,
"name": "Mobile Campaign",
"email_digest": "myemail12@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": []
},
{
"id": 8,
"name": "Pizza Campaign",
"email_digest": "myemail14@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": []
},
{
"id": 9,
"name": "Pizza Campaign",
"email_digest": "myemail15@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": [
"NEWHOTELS"
],
"counts": {
"subscribers": 0,
"unsubscribed": 0,
"cleaned": 0
},
"opt_in_type": "single",
"opt_in_requests": []
}
]
}
This endpoint retrieves a list of all lists owned by the current account.
curl "https://app.tatango.com/api/v2/lists" -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": 3,
"page": 1,
"pages_count": 1,
"lists": [
{
"id": 7,
"name": "Mobile Campaign",
"email_digest": "myemail12@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": []
},
{
"id": 8,
"name": "Pizza Campaign",
"email_digest": "myemail14@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": []
},
{
"id": 9,
"name": "Pizza Campaign",
"email_digest": "myemail15@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": [
"NEWHOTELS"
],
"counts": {
"subscribers": 0,
"unsubscribed": 0,
"cleaned": 0
},
"opt_in_type": "single",
"opt_in_requests": []
}
]
}
GET https://app.tatango.com/api/v2/lists
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.
Successful response
The response is of type object
.
Was this page helpful?