---
title: "Retrieve a list of SMS Commands from your account."
method: GET
path: "/v1/SmsCommands"
tags: ["SupersimV1SmsCommand"]
---

# Retrieve a list of SMS Commands from your account.

`GET /v1/SmsCommands`

Retrieve a list of SMS Commands from your account.

## Query parameters

- `Sim` string
- `Status` 'queued' | 'sent' | 'delivered' | 'received' | 'failed' — The status of the SMS Command. Can be: `queued`, `sent`, `delivered`, `received` or `failed`. See the [SMS Command Status Values](https://www.twilio.com/docs/iot/supersim/api/smscommand-resource#status-values) for a description of each.
- `Direction` 'to_sim' | 'from_sim' — The direction of the SMS Command. Can be `to_sim` or `from_sim`. The value of `to_sim` is synonymous with the term `mobile terminated`, and `from_sim` is synonymous with the term `mobile originated`.
- `PageSize` integer
- `Page` integer
- `PageToken` string

## Response `200`

OK

- object
  - `sms_commands` SupersimV1SmsCommand[]
    - `sid` string, nullable — The unique string that we created to identify the SMS Command resource.
    - `account_sid` string, nullable — The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the SMS Command resource.
    - `sim_sid` string, nullable — The SID of the [SIM](https://www.twilio.com/docs/iot/supersim/api/sim-resource) that this SMS Command was sent to or from.
    - `payload` string, nullable — The message body of the SMS Command sent to or from the SIM. For text mode messages, this can be up to 160 characters.
    - `status` 'queued' | 'sent' | 'delivered' | 'received' | 'failed' — The status of the SMS Command. Can be: `queued`, `sent`, `delivered`, `received` or `failed`. See the [SMS Command Status Values](https://www.twilio.com/docs/iot/supersim/api/smscommand-resource#status-values) for a description of each.
    - `direction` 'to_sim' | 'from_sim' — The direction of the SMS Command. Can be `to_sim` or `from_sim`. The value of `to_sim` is synonymous with the term `mobile terminated`, and `from_sim` is synonymous with the term `mobile originated`.
    - `date_created` string, date-time, nullable — The date and time in GMT when the resource was created specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `date_updated` string, date-time, nullable — The date and time in GMT when the resource was last updated specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `url` string, uri, nullable — The absolute URL of the SMS Command resource.
  - `meta` object
    - `first_page_url` string, uri
    - `key` string
    - `next_page_url` string, uri, nullable
    - `page` integer
    - `page_size` integer
    - `previous_page_url` string, uri, nullable
    - `url` string, uri

---

[API](https://skmtc.net/twilio/apis/supersim-v1.md) · [All operations](https://skmtc.net/twilio/apis/supersim-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/supersim-v1/versions/c0baa6eaf932/schema)