Skip to main content
POST
/
orders
Create order
curl --request POST \
  --url https://integrations.clopos.com/open-api/v2/orders \
  --header 'Content-Type: application/json' \
  --header 'x-token: <api-key>' \
  --data '
{
  "sale_type_id": 2,
  "venue_id": 1,
  "customer": {
    "id": 9,
    "phone": "+994705401040",
    "address": "123 Main St",
    "customer_discount_type": 1,
    "name": "Rahid Akhundzada"
  },
  "products": [
    {
      "product_id": 101,
      "product_name": "Pizza",
      "count": 2,
      "price": 8.5,
      "status": "new",
      "product_hash": "abc123",
      "portion_size": 1,
      "modifiers": [
        {
          "modifier_id": 501,
          "modifier_name": "Extra Cheese",
          "count": 1,
          "price": 0.5,
          "portion_size": 1
        }
      ]
    }
  ]
}
'
{
  "success": true,
  "message": "Order created",
  "data": {
    "status": "PENDING",
    "payload": {
      "updated_at": "2026-01-08T06:28:23.000000Z",
      "created_at": "2026-01-08T06:28:23.000000Z",
      "id": 295,
      "venue_id": 1
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://developer.clopos.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

x-token
string
header
required

JWT access token obtained from /v2/auth endpoint

Body

application/json

Order details

sale_type_id
integer
required

Sale type to use

Example:

2

venue_id
integer
required

Venue where the order belongs

Example:

1

customer
object
required

Customer information for the order

products
object[]
required

List of products in the order

Minimum array length: 1
auto_accept_terminal
integer

Terminal ID that auto-accepts the order

Example:

1

auto_order_accept
boolean
default:false

Auto-accept the order

auto_order_sent_to_station
boolean
default:false

Auto-send to stations after acceptance

delivery_fee
number

Delivery charge to apply

Example:

2.5

comment
string

Free text note for the order

Example:

"Leave at the door"

discount
object

Order-level discount

service_charge
object

Service charge settings

Response

Order created successfully

success
boolean
message
string
data
object