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

# Get a List of Unsubscribed Phone Numbers

> This endpoint gets a list of unsubscribed phone numbers.

## Request URL

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


## OpenAPI

````yaml GET /api/v2/lists/{ID}/subscribers/unsubscribed
openapi: 3.1.0
info:
  title: momoGood Messaging API v2
  description: >-
    The platform management API for momoGood Messaging (formerly the Tatango v2
    API). Manage lists, subscribers, custom fields, tags, webhooks, shortcodes,
    MOMT reports, and scheduled broadcasts from a single REST surface.
  version: 2.0.0
servers:
  - url: https://app.tatango.com
security:
  - basicAuth: []
paths:
  /api/v2/lists/{ID}/subscribers/unsubscribed:
    get:
      tags:
        - Subscribers
      summary: Get a List of Unsubscribed Phone Numbers
      description: This endpoint gets a list of unsubscribed phone numbers.
      parameters:
        - name: ID
          in: path
          description: ID of the list
          required: true
          schema:
            type: integer
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetUnsubscribedPhonesResponse'
              example:
                status: OK
                per_page: 10
                count: 1
                page: 1
                pages_count: 1
                phone_numbers:
                  - '2145550816'
      x-codeSamples:
        - lang: cURL
          label: cURL
          source: >-
            curl
            "https://app.tatango.com/api/v2/lists/<ID>/subscribers/unsubscribed"
            -X GET \
              -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/unsubscribed')

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

            request = Net::HTTP::Get.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('GET',
            'https://app.tatango.com/api/v2/lists/<ID>/subscribers/unsubscribed',
            false);

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

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

            request.send(null);
components:
  schemas:
    GetUnsubscribedPhonesResponse:
      type: object
      properties:
        status:
          type: string
          example: OK
          description: Status of the request ("OK" for successful requests)
        per_page:
          type: integer
          example: 10
          description: Number of results per page
        count:
          type: integer
          example: 1
          description: Total number of unsubscribed phone numbers
        page:
          type: integer
          example: 1
          description: Current page number
        pages_count:
          type: integer
          example: 1
          description: Total number of pages available
        phone_numbers:
          type: array
          items:
            type: string
          example:
            - '2145550816'
          description: Array of unsubscribed phone numbers
      required:
        - status
        - per_page
        - count
        - page
        - pages_count
        - phone_numbers
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: >-
        The momoGood Messaging API v2 authenticates 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.

````