# Send an SMS to an eSIM (/docs/api-reference/esims/send-sms)

`POST /v1/esims/{iccid}/sms`

Sends a text message to one of your eSIMs.

Takes `{ message }`, which must not be empty, and returns `{ iccid }` only when the message was sent.
An eSIM whose plan cannot be sent messages this way gives 422 / 22000 (`ESIM_SMS_NOT_SUPPORTED`); do not
retry it. A message that was not sent gives 502 / 10008. An ICCID that is not one of your eSIMs gives
404 / 10004.

## Parameters

| Name | In | Required | Type | Description |
|---|---|---|---|---|
| `iccid` | path | yes | `string` | The eSIM's ICCID, from the order item's `fulfillment.result.details.iccid`. |

## Request body

- `application/json`: `EsimSmsRequest`
- `text/json`: `EsimSmsRequest`
- `application/*+json`: `EsimSmsRequest`

## Responses

### 200

OK

- `text/plain`: `EsimSmsResult`
- `application/json`: `EsimSmsResult`
- `text/json`: `EsimSmsResult`

### 400

Invalid partner request or model validation failure.

- `application/json`: `ErrorResponse`

### 403

Forbidden

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/json`: `ErrorResponse`

### 404

Not Found

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/json`: `ErrorResponse`

### 422

Unprocessable Content

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/json`: `ErrorResponse`

### 429

Too many requests from this IP address. Wait for Retry-After seconds, then send the same request again; an order keeps its Idempotency-Key and body.

- `application/json`: `ErrorResponse`

### 502

Bad Gateway

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/json`: `ErrorResponse`

The full schemas are in the OpenAPI specification at /openapi.json.