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

# 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: 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}:
    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
          example: myemail12@gmail.com
          nullable: true
        email_subscribe:
          type: string
          nullable: true
        email_unsubscribe:
          type: string
          nullable: true
        first_optin_message:
          type: string
          example: ''
        second_optin_message:
          type: string
          example: ''
        message_help:
          type: string
          nullable: true
        message_stop:
          type: string
          nullable: true
        message_reply:
          type: string
          nullable: true
        message_already_subscribed:
          type: string
          nullable: true
        message_yes:
          type: string
          nullable: true
        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: >-
        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.

````