Unsubscribing a Subscriber

cURL

curl "https://app.tatango.com/api/v2/lists/<ID>/subscribers/<SUBSCRIBER_ID>" -X DELETE \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -u [email protected]: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
  }
}

DELETE

api

lists

{ID}

subscribers

{SUBSCRIBER_ID}

cURL

curl "https://app.tatango.com/api/v2/lists/<ID>/subscribers/<SUBSCRIBER_ID>" -X DELETE \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -u [email protected]: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

integer

required

ID of the list

SUBSCRIBER_ID

string

required

ID of the subscriber (phone number)

Response

200 - application/json

Subscriber unsubscribed successfully

status

string

required

Example:

"Subscriber unsubscribed"

subscriber

object

required

Show child attributes

subscriber.phone_number

string

required

The wireless phone number of the subscriber

Example:

"2141234567"

subscriber.subscribed_at

string<date-time>

required

Date subscriber first subscribed to this list

Example:

"2025-06-18T15:36:07Z"

subscriber.opt_in_method

string

required

Original opt-in method used

Example:

"api"

subscriber.first_name

string

First name of the subscriber

Example:

"John"

subscriber.last_name

string

Last name of the subscriber

Example:

"Doe"

subscriber.email

string

Email address of the subscriber

Example:

"[email protected]"

subscriber.birthdate

string

Birthdate of the subscriber

Example:

"19900101"

subscriber.zip_code

string

ZIP code of the subscriber

Example:

"75201"

subscriber.gender

string

Gender of the subscriber

Example:

"Male"

subscriber.cleaned_at

string<date-time> | null

Date/time of automatic unsubscription (if applicable)

subscriber.opted_out_at

string<date-time> | null

Date subscriber last unsubscribed from this list

subscriber.keyword_name

string | null

Keyword used for opt-in (if applicable)

subscriber.carrier

integer

Wireless carrier ID

Example:

383

subscriber.carrier_name

string

Wireless carrier name

Example:

"Verizon Wireless"

subscriber.global_carrier_id

string

Global wireless carrier ID

Example:

"12345"

subscriber.global_carrier_name

string

Global wireless carrier name

Example:

"Verizon"

subscriber.tags

string[]

List of tags associated with the subscriber

Example:

["vip", "customer"]

subscriber.total_messages_received

integer

The total amount of mass messages this specific subscriber has received over their lifetime from this specific list

Example:

15

Deleting tags from a Subscriber Get a List of Subscribed Phone Numbers

⌘I

v2 API Reference

Accounts

Lists

Subscribers

Custom Fields

Tags

Messaging

Message Log (MOMT) Reports

Shortcodes

Transactional Messages

Webhooks

Unsubscribing a Subscriber

Request URL

Authorizations

Path Parameters

Response

v2 API Reference

Accounts

Lists

Subscribers

Custom Fields

Tags

Messaging

Message Log (MOMT) Reports

Shortcodes

Transactional Messages

Webhooks

​Request URL

Authorizations

Path Parameters

Response

Request URL