> ## 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.

# Getting a Subscriber

> This endpoint returns information about a current subscriber.

## Request URL

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


## OpenAPI

````yaml GET /api/v2/lists/{ID}/subscribers/{SUBSCRIBER_ID}
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/{SUBSCRIBER_ID}:
    get:
      tags:
        - Subscribers
      summary: Getting a Subscriber
      description: This endpoint returns information about a current 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: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetSubscriberResponse'
              example:
                status: OK
                subscriber:
                  phone_number: '2065551111'
                  cleaned_at: null
                  subscribed_at: '2025-06-18T15:36:07Z'
                  opted_out_at: null
                  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 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/<SUBSCRIBER_ID>')

            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/<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:
    GetSubscriberResponse:
      type: object
      properties:
        status:
          type: string
          example: OK
        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
            - 'null'
          format: date-time
          description: Date/time of automatic unsubscription (if applicable)
        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
            - 'null'
          format: date-time
          description: Date subscriber last unsubscribed from this list
        opt_in_method:
          type: string
          description: Original opt-in method used
          example: api
        keyword_name:
          type:
            - string
            - 'null'
          description: Keyword used for opt-in (if applicable)
        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: >-
        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.

````