> ## Documentation Index
> Fetch the complete documentation index at: https://developers.mioesim.com/llms.txt
> Use this file to discover all available pages before exploring further.
# POST /api_esim/addEsimOrder — Place a SIM card order
> Place an eSIM or physical SIM card order using a SKU ID and price ID. Returns activation codes, QR code data, and ICCID for each card ordered.
This is the core ordering endpoint. Pass a SKU ID and price ID (from [Get Packages](/api-reference/get-packages)) to purchase one or more SIM cards. The response includes eSIM activation details — SM-DP+ address, activation code, LPA string, and PDF link.
```
POST https://bpm.mioesim.com/api_esim/addEsimOrder
```
## Request parameters
Session token from [Login](/api-reference/login).
Product SKU ID.
Package price ID from [Get Packages](/api-reference/get-packages).
Number of SIM cards to order.
Request signature.
Required when `supportDaypass=1`. Number of days for a DayPass order (must satisfy `minDay`–`maxDay`).
Required when `mustDate=1`. Plan start date in `MM/dd/yyyy` format.
Controls response format: `0` or empty = return order number only; `1` = return full order details; `2` = return PDF URL info.
Required for physical SIM orders. DP identifier from [Get DP Info](/api-reference/get-dp-info).
For physical SIM: comma-separated list of ICCIDs. Count must equal `count`.
Customer email address. eSIM PDF is sent here if `isSendEmail=1`.
`1` to send email; `0` or empty to skip.
PDF language code (e.g. `en-US`, `zh-CN`). Defaults to English. See [PDF Languages](/reference/pdf-languages).
Your platform's order ID for reconciliation.
Your platform's line item ID.
Optional order notes.
## Response fields
When `backInfo=1`, the response includes full order details:
MIOeSIM order number (e.g. `EP20240124000013`).
Product display name.
Order creation time (GMT+8).
Quantity ordered.
Total price charged.
Order status. See [Order Statuses](/reference/order-statuses).
Package price ID.
eSIM card details — one entry per SIM card ordered.
Card ICCID.
eSIM phone number.
SM-DP+ server address.
Activation code.
LPA string for Android: `LPA:1$sm_dp_address$activationCode`.
Latest date to activate the eSIM.
Total data (e.g. `"6GB"`).
Validity in days.
Data consumed in MB.
PDF download link (when generated).
APN setting.
## Example
```bash cURL theme={null}
curl -X POST https://bpm.mioesim.com/api_esim/addEsimOrder \
-d "token=YOUR_TOKEN" \
-d "skuId=45" \
-d "priceId=441" \
-d "count=1" \
-d "backInfo=1" \
-d "customerEmail=user@example.com" \
-d "isSendEmail=1" \
-d "pdfLanguage=en-US" \
-d "sign=YOUR_SIGN"
```
```json Success (backInfo=0) theme={null}
{ "code": "0", "message": "success", "data": "EP20240124000013" }
```
```json Success (backInfo=1) theme={null}
{
"code": "0",
"message": "success",
"data": {
"orderNum": "EP20240124000013",
"display": "Australia",
"purchaseDate": "2024-01-24(GMT+8)",
"count": 1,
"price": "9.89",
"status": 0,
"priceId": 9726,
"cardApiDtoList": [
{
"iccid": "934801019851134300",
"mobileNumber": "0841823354",
"sm_dp_address": "ais.prod.ondemandconnectivity.com",
"activationCode": "SEW7JEBMFGPRVSPD",
"code": "LPA:1$ais.prod.ondemandconnectivity.com$SEW7JEBMFGPRVSPD",
"activateBefore": "2024-02-24(GMT+8)",
"data": "6GB",
"validity": 8,
"usedMB": "0.0",
"apn": "plus"
}
]
}
}
```
Use [Verify Resources](/api-reference/verify-resources) before placing large orders to confirm sufficient card inventory.