---
title: "POST /v1/IpCommands"
method: POST
path: "/v1/IpCommands"
tags: ["SupersimV1IpCommand"]
---

# POST /v1/IpCommands

`POST /v1/IpCommands`

Send an IP Command to a Super SIM.

## Response `201`

Created

- 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://docs.korewireless.com/en-us/v/api/global-resources/iam/account) that created the IP Command resource.
  - `sim_sid` string, nullable — The SID of the [Super SIM](https://docs.korewireless.com/en-us/v/api/products/supersim/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://docs.korewireless.com/en-us/v/api/products/supersim/sim-resource) that this IP Command was sent to or from.
  - `status` 'queued' | 'sent' | 'received' | 'failed', nullable — The delivery status of the IP Command. This is one of the following: “queued”, “sent”, “failed” or “received”.
  - `direction` 'to_sim' | 'from_sim', nullable — 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, nullable — 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', nullable — Indicates how the payload is encoded. 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.

---

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