eSIM API
POST /orders/with-wallet
Oauth2
application/json

Body

  • planID string

    The Plan ID which is linked to the Order

  • accountID string

    The Account ID linked to this Order. Allows to generate orders OnBehalf of another Account. If omitted this will default to the Account associated with the User making the query.

  • currencyISO string

    The currency ISO for the Order. If omitted, this will default to the preferred currency for the Account.

  • notifyRecipient boolean

    If true, a notification, push / sms or email will be sent to the end User based on the Account preferences.

  • quantity number

    The quantity of Plans to purchase for this Order.

  • userNanoIDs array[string]

    A list of Users ID for which the Order is being generated.

Responses

  • 200 application/json

    Order creation succeeded

    Hide response attributes Show response attributes object
    • id string
    • accountID string
    • planID string
    • userID string
    • createdAt date
    • status string
    • type string
POST /orders/with-wallet 
curl \
 --request POST 'https://zim.api.dev.zimconnections.com/orders/with-wallet' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"planID":"plan_guaGulGcrqgTYboPvetgE","accountID":"acct_ozxEbkTyvLPhhoglcALXE","currencyISO":"USD","notifyRecipient":true,"quantity":1,"userNanoIDs":["user_ozxEbkTyvLPhhoglcALXR"]}'
Request examples 
{
  "planID": "plan_guaGulGcrqgTYboPvetgE",
  "accountID": "acct_ozxEbkTyvLPhhoglcALXE",
  "currencyISO": "USD",
  "notifyRecipient": true,
  "quantity": 1,
  "userNanoIDs": [
    "user_ozxEbkTyvLPhhoglcALXR"
  ]
}
Response examples (200) 
{
  "id": "ordr_GMAVA4ISiqfWSG0ArGOzB",
  "type": "ONE_OFF",
  "status": "PROCESSING",
  "userID": "user_yf95A86RIkVxau2gzBsjV",
  "accountID": "acct_ozxEbkTyvLPhhoglcALXE",
  "createdAt": "2026-03-12T14:39:23.149Z"
}