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

# Retrieve List

> This endpoint retrieves a specific list.

## Request URL

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


## OpenAPI

````yaml GET /api/v2/lists/{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}:
    get:
      tags:
        - Lists
      summary: Retrieve List
      description: Retrieves a specific list.
      parameters:
        - name: ID
          in: path
          description: The ID of the list to retrieve.
          required: true
          schema:
            type: integer
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RetrieveListResponse'
              example:
                status: OK
                list:
                  id: 2
                  name: Book Campaign
                  email_digest: myemail2@gmail.com
                  email_subscribe: null
                  email_unsubscribe: null
                  first_optin_message: ''
                  second_optin_message: ''
                  message_help: null
                  message_stop: null
                  message_reply: null
                  message_already_subscribed: null
                  message_yes: null
                  keyword_names: []
                  counts:
                    subscribers: 0
                    unsubscribed: 0
                    cleaned: 0
                  opt_in_type: single
                  opt_in_requests: []
      x-codeSamples:
        - lang: cURL
          label: cURL
          source: |-
            curl "https://app.tatango.com/api/v2/lists/<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>')
            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>',
            false);

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

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

            request.send(null);
components:
  schemas:
    RetrieveListResponse:
      type: object
      properties:
        status:
          type: string
          example: OK
        list:
          $ref: '#/components/schemas/List'
      required:
        - status
        - list
    List:
      type: object
      properties:
        id:
          type: integer
          example: 7
        name:
          type: string
          example: Mobile Campaign
        email_digest:
          type:
            - string
            - 'null'
          example: myemail12@gmail.com
        email_subscribe:
          type:
            - string
            - 'null'
        email_unsubscribe:
          type:
            - string
            - 'null'
        first_optin_message:
          type: string
          example: ''
        second_optin_message:
          type: string
          example: ''
        message_help:
          type:
            - string
            - 'null'
        message_stop:
          type:
            - string
            - 'null'
        message_reply:
          type:
            - string
            - 'null'
        message_already_subscribed:
          type:
            - string
            - 'null'
        message_yes:
          type:
            - string
            - 'null'
        keyword_names:
          type: array
          items:
            type: string
        counts:
          $ref: '#/components/schemas/ListCounts'
        opt_in_type:
          type: string
          example: single
        opt_in_requests:
          type: array
          items:
            type: object
      required:
        - id
        - name
        - keyword_names
        - counts
        - opt_in_type
    ListCounts:
      type: object
      properties:
        subscribers:
          type: integer
          example: 0
        unsubscribed:
          type: integer
          example: 0
        cleaned:
          type: integer
          example: 0
      required:
        - subscribers
        - unsubscribed
        - cleaned
  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.

````