---
title: "Retrieve a list of IP Commands from your account."
method: GET
path: "/v1/IpCommands"
tags: ["SupersimV1IpCommand"]
---

# Retrieve a list of IP Commands from your account.

`GET /v1/IpCommands`

Retrieve a list of IP Commands from your account.

## Query parameters

- `Sim` string
- `SimIccid` string
- `Status` 'queued' | 'sent' | 'received' | 'failed' — The delivery status of the IP Command. This is one of the following: “queued”, “sent”, “failed” or “received”.
- `Direction` 'to_sim' | 'from_sim' — Either `to_sim` or `from_sim`. Indicates whether the IP Command resource was sent from or to the Super SIM.
- `PageSize` integer
- `Page` integer
- `PageToken` string

## Response `200`

OK

- object
  - `ip_commands` SupersimV1IpCommand[]
    - `sid` string, nullable — The unique string that we created to identify the IP Command resource.
    - `account_sid` string, nullable — The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the IP Command resource.
    - `sim_sid` string, nullable — The SID of the [Super SIM](https://www.twilio.com/docs/iot/supersim/api/sim-resource) that this IP Command was sent to or from.
    - `sim_iccid` string, nullable — The [ICCID](https://en.wikipedia.org/wiki/Subscriber_identity_module#ICCID) of the [Super SIM](https://www.twilio.com/docs/iot/supersim/api/sim-resource) that this IP Command was sent to or from.
    - `status` 'queued' | 'sent' | 'received' | 'failed' — The delivery status of the IP Command. This is one of the following: “queued”, “sent”, “failed” or “received”.
    - `direction` 'to_sim' | 'from_sim' — Either `to_sim` or `from_sim`. Indicates whether the IP Command resource was sent from or to the Super SIM.
    - `device_ip` string, nullable — The IP address of the device that the IP Command was sent to or received from. For an IP Command sent to a Super SIM, `device_ip` starts out as `null`, and once the IP Command is “sent”, the `device_ip` will be filled out. An IP Command sent from a Super SIM have its `device_ip` always set.
    - `device_port` integer — For an IP Command sent to a Super SIM, it would be the destination port of the IP message. For an IP Command sent from a Super SIM, it would be the source port of the IP message.
    - `payload_type` 'text' | 'binary' — Either “text” or “binary”. For an IP Command sent to a Super SIM, `payload_type` is configurable. For an IP Command sent from a Super SIM, `payload_type` is always “binary”.
    - `payload` string, nullable — The payload that is carried in the IP/UDP message. The payload can be encoded in either text or binary format. For text payload, UTF-8 encoding must be used. For an IP Command sent to a Super SIM, the payload is appended to the IP/UDP message “as is”. The payload should not exceed 1300 bytes. For an IP Command sent from a Super SIM, the payload from the received IP/UDP message is extracted and sent in binary encoding. For an IP Command sent from a Super SIM, the payload should not exceed 1300 bytes. If it is larger than 1300 bytes, there might be fragmentation on the upstream and the message may appear truncated.
    - `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 IP 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

## Changes

- **2025-02-20** (v1) `40aef886b303` — 1 breaking
  - for the `query` request parameter `PageSize`, the format changed from no format to `int64`
- **2024-08-26** (v1) `af3b4d2ec72e` — 1 info
  - the `device_port` response's property default value `0` was added for the status `200`
- **2023-08-10** (v1) `4c8f6063ae9d` — 1 info
  - api tag `SupersimV1IpCommand` added
- **2023-02-02** (v1) `a6e2859a656d` — 2 info
  - added the new optional `query` request parameter `Page`
  - added the new optional `query` request parameter `PageToken`
- **2023-01-13** (v1) `42d026552cc2` — 2 breaking
  - the response property `meta/next_page_url` became nullable for the status `200`
  - the response property `meta/previous_page_url` became nullable for the status `200`

[Change history](https://skmtc.dev/twilio/apis/supersim-v1/changes/v1/IpCommands/get.md)

---

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