---
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

---

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