Submit Order

POST

/v1/orders

This endpoint allows you to submit an order to the Airalo Partners API. Provide the required information, such as quantity and package ID, and include optional description if needed.

The access token, obtained from the "Request Access Token" endpoint, should be included in the request.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/v1/orders' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{token}}' \
--form 'quantity="1"' \
--form 'package_id="kallur-digital-7days-1gb"' \
--form 'type="sim"' \
--form 'description="1 sim kallur-digital-7days-1gb"'

Response Example

422 - Submit Order (422)

{
  "data": {
    "package_id": "The selected package is invalid.",
    "quantity": "The quantity may not be greater than 50."
  },
  "meta": {
    "message": "the parameter is invalid"
  }
}

Request

Header Params

string

required

Example:

application/json

Authorization

string

required

Example:

Bearer {{token}}

Body Params multipart/form-data

quantity

string

required

Required. The quantity of items in the order. Maximum of 50.

Example:

package_id

string

required

Required. The package ID associated with the order. You can obtain this from the "Packages / Get Packages" endpoint.

Example:

kallur-digital-7days-1gb

type

string

required

Optional. The only possible value for this endpoint is "sim". If left empty, default "sim" value will be used.

Example:

sim

description

string

required

Optional. A custom description for the order, which can help you identify it later.

Example:

1 sim kallur-digital-7days-1gb

Responses

🟠422Submit Order (422)

application/json

Body

data

object

required

package_id

string

required

quantity

string

required