> ## Documentation Index
> Fetch the complete documentation index at: https://platform.tatango.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Unsubscribing a Subscriber

> This endpoint unsubscribes a subscriber.

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

## Request URL

```http theme={null}
DELETE https://app.tatango.com/api/v2/lists/{ID}/subscribers/{SUBSCRIBER_ID}
```


## OpenAPI

````yaml DELETE /api/v2/lists/{ID}/subscribers/{SUBSCRIBER_ID}
openapi: 3.1.0
info:
  title: Tatango Legacy v2 API
  description: Tatango legacy v2 API endpoints for existing integrations.
  version: 2.0.0
servers:
  - url: https://app.tatango.com
security:
  - basicAuth: []
paths:
  /api/v2/lists/{ID}/subscribers/{SUBSCRIBER_ID}:
    delete:
      tags:
        - Subscribers
      summary: Unsubscribing a Subscriber
      description: This endpoint unsubscribes a subscriber.
      parameters:
        - name: ID
          in: path
          description: ID of the list
          required: true
          schema:
            type: integer
        - name: SUBSCRIBER_ID
          in: path
          description: ID of the subscriber (phone number)
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Subscriber unsubscribed successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnsubscribeSubscriberResponse'
              example:
                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
      x-codeSamples:
        - lang: cURL
          label: cURL
          source: >-
            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: "
        - lang: Ruby
          label: Ruby
          source: >-
            require 'net/http'

            require 'uri'


            uri =
            URI.parse('https://app.tatango.com/api/v2/lists/<ID>/subscribers/<SUBSCRIBER_ID>')

            http = Net::HTTP.new(uri.host, uri.port)

            request = Net::HTTP::Delete.new(uri.request_url)

            request.basic_auth("emailaddress@mydomain.com", "my_api_key")

            response = http.request(request)
        - lang: JavaScript
          label: JavaScript
          source: >-
            var request = new XMLHttpRequest();

            request.open('DELETE',
            'https://app.tatango.com/api/v2/lists/<ID>/subscribers/<SUBSCRIBER_ID>',
            false);

            request.setRequestHeader('Content-Type', 'application/json');

            request.setRequestHeader('Authorization', 'Basic ' +
            btoa('emailaddress@mydomain.com:my_api_key'));

            request.send(null);
components:
  schemas:
    UnsubscribeSubscriberResponse:
      type: object
      properties:
        status:
          type: string
          example: Subscriber unsubscribed
        subscriber:
          $ref: '#/components/schemas/Subscriber'
      required:
        - status
        - subscriber
    Subscriber:
      type: object
      properties:
        phone_number:
          type: string
          description: The wireless phone number of the subscriber
          example: '2141234567'
        first_name:
          type: string
          description: First name of the subscriber
          example: John
        last_name:
          type: string
          description: Last name of the subscriber
          example: Doe
        email:
          type: string
          description: Email address of the subscriber
          example: john.doe@example.com
        birthdate:
          type: string
          description: Birthdate of the subscriber
          example: '19900101'
        zip_code:
          type: string
          description: ZIP code of the subscriber
          example: '75201'
        gender:
          type: string
          description: Gender of the subscriber
          example: Male
        cleaned_at:
          type: string
          format: date-time
          description: Date/time of automatic unsubscription (if applicable)
          nullable: true
        subscribed_at:
          type: string
          format: date-time
          description: Date subscriber first subscribed to this list
          example: '2025-06-18T15:36:07Z'
        opted_out_at:
          type: string
          format: date-time
          description: Date subscriber last unsubscribed from this list
          nullable: true
        opt_in_method:
          type: string
          description: Original opt-in method used
          example: api
        keyword_name:
          type: string
          description: Keyword used for opt-in (if applicable)
          nullable: true
        carrier:
          type: integer
          description: Wireless carrier ID
          example: 383
        carrier_name:
          type: string
          description: Wireless carrier name
          example: Verizon Wireless
        global_carrier_id:
          type: string
          description: Global wireless carrier ID
          example: '12345'
        global_carrier_name:
          type: string
          description: Global wireless carrier name
          example: Verizon
        tags:
          type: array
          items:
            type: string
          description: List of tags associated with the subscriber
          example:
            - vip
            - customer
        total_messages_received:
          type: integer
          description: >-
            The total amount of mass messages this specific subscriber has
            received over their lifetime from this specific list
          example: 15
      required:
        - phone_number
        - subscribed_at
        - opt_in_method
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: >-
        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.

````