---
title: "Create or update orders"
method: POST
path: "/orders/"
tags: ["orders"]
---

# Create or update orders

`POST /orders/`

## Request

- Base URL: `https://api.hive.co/v2`
- URL: `https://api.hive.co/v2/orders/`
- Auth: HTTP bearer

Push order/ticket data to Hive. An order is scoped to a single event; split a multi-event purchase into one order per `event_id`.

## Headers

- `X-Partner-Id` string, required

## Request body

- SaveOrdersRequest
  - `orders` OrderRequest[], required
    - `order_id` string, required
    - `event_id` string, required
    - `status` 'started' | 'completed' | 'partial_payment' | 'cancelled' | 'pending', required
    - `items` OrderItemRequest[], required
      - `item_id` string, required
      - `price` number, double, required
      - `quantity` integer, required
      - `status` 'started' | 'completed' | 'cancelled' | 'transferred' | 'resold'
      - `tier_id` string
      - `tier_name` string
    - `user` UserRequest, required
      - `email` string, email
      - `phone_number` string
      - `first_name` string
      - `last_name` string
      - `gender` 'male' | 'female' | 'non_binary' | 'unknown'
      - `birthday` string, date-time
      - `address` AddressRequest
        - `address` string
        - `city` string
        - `state` string
        - `country` string
        - `zip` string
      - `is_email_opt_in` boolean
      - `is_sms_opt_in` boolean
      - `custom_properties` object
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `purchased_at` string, date-time

## Response `202`

Received and queued for background processing. Not yet applied.

- OrdersCreateResponse202: Empty response body

## Other responses

- `422`: Validation failed. For a batch write this is all-or-nothing. Field errors are keyed by resource name, then item index, then field path, query-parameter errors are keyed by parameter name, service-level rejections use a flat `errors` list.

---

[API](https://skmtc.dev/hive-co/apis/hive-api.md) - [All operations](https://skmtc.dev/hive-co/apis/hive-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hive-co/apis/hive-api/revisions/aa145f089347?raw)