curl "https://app.tatango.com/api/v2/lists/<ID>/subscribers/<SUBSCRIBER_ID>" -X DELETE \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -u emailaddress@mydomain.com:my_api_key \
  -H "Host: example.org" \
  -H "Cookie: "
{
  "status": "Subscriber unsubscribed",
  "subscriber": {
    "phone_number": "2065551111",
    "cleaned_at": null,
    "subscribed_at": "2025-06-18T15:36:07Z",
    "opted_out_at": "2025-06-18T18:29:16Z",
    "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
  }
}

This endpoint removes a subscriber from a list by unsubscribing them. The subscriber will no longer receive messages from this specific list.

​
Request URL

DELETE https://app.tatango.com/api/v2/lists/{ID}/subscribers/{SUBSCRIBER_ID}

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

ID of the list

​
SUBSCRIBER_ID
string
required

ID of the subscriber (phone number)

Response

200 - application/json

Subscriber unsubscribed successfully

The response is of type object.