---
title: "Retrieve a list of short-codes belonging to the account used to make the request"
method: GET
path: "/2010-04-01/Accounts/{AccountSid}/SMS/ShortCodes.json"
tags: ["Api20100401ShortCode"]
---

# Retrieve a list of short-codes belonging to the account used to make the request

`GET /2010-04-01/Accounts/{AccountSid}/SMS/ShortCodes.json`

Retrieve a list of short-codes belonging to the account used to make the request

## Path parameters

- `AccountSid` string, required

## Query parameters

- `FriendlyName` string
- `ShortCode` string
- `PageSize` integer
- `Page` integer
- `PageToken` string

## Response `200`

OK

- object
  - `end` integer
  - `first_page_uri` string, uri
  - `next_page_uri` string, uri, nullable
  - `page` integer
  - `page_size` integer
  - `previous_page_uri` string, uri, nullable
  - `start` integer
  - `uri` string, uri
  - `short_codes` ApiV2010AccountShortCode[]
    - `account_sid` string, nullable — The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created this ShortCode resource.
    - `api_version` string, nullable — The API version used to start a new TwiML session when an SMS message is sent to this short code.
    - `date_created` string, date-time-rfc-2822, nullable — The date and time in GMT that this resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
    - `date_updated` string, date-time-rfc-2822, nullable — The date and time in GMT that this resource was last updated, specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
    - `friendly_name` string, nullable — A string that you assigned to describe this resource. By default, the `FriendlyName` is the short code.
    - `short_code` string, nullable — The short code. e.g., 894546.
    - `sid` string, nullable — The unique string that that we created to identify this ShortCode resource.
    - `sms_fallback_method` 'GET' | 'POST', http-method, nullable — The HTTP method we use to call the `sms_fallback_url`. Can be: `GET` or `POST`.
    - `sms_fallback_url` string, uri, nullable — The URL that we call if an error occurs while retrieving or executing the TwiML from `sms_url`.
    - `sms_method` 'GET' | 'POST', http-method, nullable — The HTTP method we use to call the `sms_url`. Can be: `GET` or `POST`.
    - `sms_url` string, uri, nullable — The URL we call when receiving an incoming SMS message to this short code.
    - `uri` string, nullable — The URI of this resource, relative to `https://api.twilio.com`.

---

[API](https://skmtc.net/twilio/apis/api-v2010.md) · [All operations](https://skmtc.net/twilio/apis/api-v2010/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/api-v2010/revisions/6b6ffccef14c/schema)