---
title: "Bulk Order"
method: POST
path: "/order/bulk"
tags: ["Order"]
---

# Bulk Order

`POST /order/bulk`

This method allows the calling application to create a Bulk Order.
Please note received Bulk Order Request will be processed by AIR after a HTTP Response is sent to the calling application.

## Headers

- `X-EES-AUTH-CLIENT-ID` string, string, required
- `X-EES-AUTH-HASH` string, string, required
- `Connection` 'close' | 'keep-alive'
- `Accept-Encoding` '' | 'gzip' | 'deflate' | 'gzip,deflate'
- `X-EES-TRANSACTION-ID` string, string
- `X-EES-RETRY` string, string
- `X-CUSTOM-SUBSYSTEM-ID` string, string
- `X-CUSTOM-KEY` string, string

## Request body

- TokenOrderBulkPayload
  - `reference` string — External reference to this order.
  - `details` object
    - `expectedStatus` 'ACTIVE' | 'INACTIVE' — The account status to apply to all accounts created for each item in teh items array. Can be either ACTIVE or INACTIVE.
  - `items` object[]
    - `campaignId` string, string — EES AIR Campaign ID
    - `programmeId` string, string — EES AIR Programme ID
    - `schemeId` string, string — EES AIR Scheme ID
    - `denomination` string, string
    - `quantity` string, string
  - `notes` string, string

## Response `201`

Created

- object
  - `orderId` integer — EES AIR Order ID
  - `reference` string — External reference to this order.
  - `details` object
    - `expectedStatus` 'ACTIVE' | 'INACTIVE' — The account status to apply to all accounts created for each item in teh items array. Can be either ACTIVE or INACTIVE.
  - `items` object[]
    - `campaignId` string, string — EES AIR Campaign ID
    - `programmeId` string, string — EES AIR Programme ID
    - `schemeId` string, string — EES AIR Scheme ID
    - `denomination` string, string
    - `quantity` string, string
  - `notes` string, string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `415` — Unsupported Media Type
- `429` — Too Many Requests
- `500` — Server Error
- `503` — Service Unavailable
- `504` — Gateway Timeout

---

[API](https://skmtc.net/eagleeye/apis/wallet-api.md) · [All operations](https://skmtc.net/eagleeye/apis/wallet-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eagleeye/wallet-api/revisions/90a122bb14cc/schema)