# Provision a deferred eSIM (/docs/api-reference/esims/provision)

`POST /v1/esims/{id}/provisioning`

Provisions a deferred eSIM bought with `inputs.isInstant: false` and returns it.

Creates the eSIM for an order item that delivered an entitlement, and returns it as `GET /esims/{iccid}`
does. The item's result moves to `provisioning.status` `processing` and then `ready`, and each
change sends an `order.fulfillment.updated` webhook. An `Idempotency-Key` header with a UUID is
required: a retry with the same key and body after the call finished returns the eSIM as it reads now and starts
nothing again, 409 / 12002 with `Retry-After` while the call is still running, and a changed body gives
409 / 12001. The optional body
`{ travelStartDate }` is needed when the plan requires the first day of travel and the order did not send
it (400 / 10001 without it); a date other than the one recorded, or a new date once provisioning has started,
gives 409 / 10005. An instant eSIM gives 400 / 10001, and an ID that names no eSIM purchase of yours, such as a
top-up item, gives 404 / 10004.

## Parameters

| Name | In | Required | Type | Description |
|---|---|---|---|---|
| `id` | path | yes | `string` | The order item ID of the deferred eSIM purchase. |
| `Idempotency-Key` | header | yes | `string` | UUID idempotency key for safe retries of this operation. |

## Request body

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

## Responses

### 200

OK

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

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

### 409

The idempotency key: a request with this key is still running (12002): send the same request, key and body again after Retry-After seconds; or it was used for a different request (12001). A finished request sent again with the same key and body returns 200 with the result of the first call, rebuilt from the record that call created as it reads now: nothing runs again, and a status that has moved on since shows its current value.

- `application/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`

### 503

Idempotency state is temporarily unavailable; retry the same request and key.

- `application/json`: `ErrorResponse`

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