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

# List All Lists

> This endpoint retrieves a list of all lists owned by the current account.

## Request URL

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


## OpenAPI

````yaml GET /api/v2/lists
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:
    get:
      tags:
        - Lists
      summary: List All Lists
      description: Retrieves a list of all lists owned by the current account.
      parameters:
        - name: include_deleted
          in: query
          description: Whether to include deleted lists in the response. Defaults to true.
          required: false
          schema:
            type: boolean
            default: true
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListAllListsResponse'
              example:
                status: OK
                per_page: 10
                count: 3
                page: 1
                pages_count: 1
                lists:
                  - id: 7
                    name: Mobile Campaign
                    email_digest: myemail12@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: []
                  - id: 8
                    name: Pizza Campaign
                    email_digest: myemail14@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: []
                  - id: 9
                    name: Pizza Campaign
                    email_digest: myemail15@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:
                      - NEWHOTELS
                    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" -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')
            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', false);

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

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

            request.send(null);
components:
  schemas:
    ListAllListsResponse:
      type: object
      properties:
        status:
          type: string
          example: OK
        per_page:
          type: integer
          example: 10
        count:
          type: integer
          example: 3
        page:
          type: integer
          example: 1
        pages_count:
          type: integer
          example: 1
        lists:
          type: array
          items:
            $ref: '#/components/schemas/List'
      required:
        - status
        - lists
    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.

````