# Download an eSIM

## Download an eSIM based on ICCID

> Downloads generate a new Matching ID to a QR code associated with a given ICCID, provided its state is set to “available”. The API requires ICCID

```json
{"openapi":"3.0.0","info":{"title":"Filtered eSIM API","version":"1.0"},"paths":{"/api/v1/eSIM/download":{"post":{"description":"Downloads generate a new Matching ID to a QR code associated with a given ICCID, provided its state is set to “available”. The API requires ICCID","operationId":"downloadOrder","requestBody":{"content":{"application/json":{"schema":{"properties":{"iccid":{"description":"The ICCID (19 or 20 characters) associated with the order to download.","type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"description":"The response data containing the cancellation details.","properties":{"header":{"description":"contains value of functionExecutionStatus.","properties":{"functionExecutionStatus":{"description":"contains value of status of cancellation.","properties":{"status":{"description":"Status of order cancellation","type":"string"}},"type":"object"}},"type":"object"},"matchingId":{"description":"matchingId of SIM","type":"string"}},"type":"object"}},"type":"object"}}},"description":"Successfully downloaded and confirmed the order."},"400":{"content":{"application/json":{"schema":{"properties":{"error":{"description":"Error message indicating validation failure or incorrect input.","type":"string"}},"type":"object"}}},"description":"Bad request, invalid ICCID format, or missing required parameters."},"500":{"content":{"application/json":{"schema":{"properties":{"error":{"description":"Error message describing what went wrong.","type":"string"}},"type":"object"}}},"description":"Internal server error, failed to download or confirm the order."}},"summary":"Download an eSIM based on ICCID","tags":["eSIM"]}}}}
```