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

# Listing Account Shortcodes

> This endpoint gets a list of shortcodes provisioned on your account.

## Request URL

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


## OpenAPI

````yaml GET /api/v2/shortcodes
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/shortcodes:
    get:
      tags:
        - Shortcodes
      summary: Listing Account Shortcodes
      description: This endpoint gets a list of shortcodes provisioned on your account.
      parameters:
        - name: ID
          in: query
          description: ID of MOMT Report to get status of
          required: false
          schema:
            type: integer
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListingAccountShortCodesResponse'
              example:
                status: OK
                shortcodes:
                  - '33733'
        '401':
          description: Invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                status: error
                error: API key authorization failure
        '403':
          description: Disabled API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              example:
                status: error
                error: This API key is disabled
      x-codeSamples:
        - lang: cURL
          label: cURL
          source: |-
            curl "https://app.tatango.com/api/v2/shortcodes" -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/shortcodes')
            http = Net::HTTP.new(uri.host, uri.port)
            request = Net::HTTP::Get.new(uri.request_uri)
            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/shortcodes',
            false);

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

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

            request.send(null);
components:
  schemas:
    ListingAccountShortCodesResponse:
      type: object
      properties:
        status:
          type: string
          example: OK
        shortcodes:
          type: array
          items:
            type: string
          example:
            - '33733'
      required:
        - status
        - shortcodes
    ErrorResponse:
      type: object
      properties:
        status:
          type: string
          example: error
        error:
          type: string
          example: This API key is disabled
      required:
        - status
        - error
  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.

````