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

## Changes

- **2025-02-20** (v2010) `ed1b16ce6378` — 1 breaking
  - for the `query` request parameter `PageSize`, the format changed from no format to `int64`
- **2024-04-18** (v2010) `cf63f47f41aa` — 8 info
  - removed the `DELETE` enum value from the `short_codes/items/sms_fallback_method` response property for the response status `200`
  - removed the `DELETE` enum value from the `short_codes/items/sms_method` response property for the response status `200`
  - removed the `HEAD` enum value from the `short_codes/items/sms_fallback_method` response property for the response status `200`
  - removed the `HEAD` enum value from the `short_codes/items/sms_method` response property for the response status `200`
  - …4 more

[Change history](https://skmtc.dev/twilio/apis/api-v2010/changes/2010-04-01/Accounts/:AccountSid/SMS/ShortCodes.json/get.md)

---

[API](https://skmtc.dev/twilio/apis/api-v2010.md) · [All operations](https://skmtc.dev/twilio/apis/api-v2010/llms.txt) · [OpenAPI document](https://skmtc.dev/twilio/apis/api-v2010/revisions/78e76cc93c35?raw)