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

# Add order

`POST /order/add-order`

## Request

- Base URL: `https://demo.onlinebillingform.com/api/v2`
- URL: `https://demo.onlinebillingform.com/api/v2/order/add-order`
- Auth: HTTP bearer

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

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

---

[API](https://skmtc.dev/billingserv/apis/billingserv-api-v2.md) - [All operations](https://skmtc.dev/billingserv/apis/billingserv-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/billingserv/apis/billingserv-api-v2/revisions/232ab5ca8413?raw)