---
title: "Add order"
method: POST
path: "/order/add-order"
tags: ["Order"]
---

# Add order

`POST /order/add-order`

Use this BillingServ API endpoint to add order. Review the response for the operation result or validation errors.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `customer_id` integer, required
  - `package_id` integer, required
  - `cycle_id` integer, required
  - `price` number, required
  - `options` OrderOptionsRequest — Matching option arrays. Each index represents one selected package option. For hosted checkout, option prices are resolved server-side from the selected package.
    - `id` integer[], required
    - `amount` number[], required
    - `value` string[], required
    - `cycle_type` integer[], required

## Response `200`

OK

- ApiResponse
  - `success` boolean

## Other responses

- `401` — Missing or invalid API key
- `403` — Authenticated key does not have permission for this endpoint
- `404` — Package or customer not found or not available to this API account
- `409` — Idempotency key conflict or request already in progress
- `422` — Validation error
- `500` — Order creation failed

## Changes

- **2026-08-22** `6b9208b64456` — 4 warning, 11 info
  - removed the request property `options.amount`
  - removed the request property `options.cycle_type`
  - removed the request property `options.id`
  - removed the request property `options.value`
  - …11 more

[Change history](https://skmtc.dev/b-cdn/apis/billingserv-api-v2/changes/order/add-order/post.md)

---

[API](https://skmtc.dev/b-cdn/apis/billingserv-api-v2.md) · [All operations](https://skmtc.dev/b-cdn/apis/billingserv-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/b-cdn/billingserv-api-v2/revisions/76cfbed5eb40/schema)