Skip to content

Place a new order

Request

Place a new order for one or more tickets. A single order can include multiple ticket types of a single event, or from multiple events. When a new order is created tickets are reserved for a fixed period of time until the order is settled, cancelled or times out.

If the tickets being ordered are free (i.e. the order total is $0.00), the order is fuliflled immediately and tickets delivered to the customer's account.

Security
SessionKey(Required scopes: customeradministrator)
Path
numberstringrequired

Alphanumeric identifier of the user account

Bodyapplication/json
itemsArray of objectsrequired

Sections for which to order tickets. The object's keys are the URI of the event section for which tickets are being ordered, while its values are the number of tickets to order for the section.

curl -i -X POST \
  'https://docs.ticketingevents.com/_mock/openapi/accounts/{number}/orders' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY_HERE' \
  -d '{
    "items": [
      {
        "tier": 16993964783416,
        "quantity": 2
      },
      {
        "tier": 16971671292759,
        "quantity": 2
      }
    ]
  }'

Responses

The order was successfully placed.

Bodyapplication/json
selfstring, (uri)

URI of the order resource

numberstring

Unique identifier of the order

statusstring

Current status of the order

placedstring, (date-time)

The date and time at which the order was placed

subtotalnumber, (float)

Total cost of the ordered items, before convenience fees are applied

feesnumber, (float)

Total applicable convenience fees for this order

totalnumber, (float)

Total to be paid for this order inclusive of item costs (subtotal) and fees

itemsArray of objects

List of items that were ordered

paymentobject

Details of the payment for this order.

Response
{
  "self": "/orders/E8D946240203",
  "number": "E8D946240203",
  "status": "Placed",
  "placed": "2024-02-03T23:22:31+00:00",
  "subtotal": 140,
  "fees": 3.96,
  "total": 143.96,
  "items": [
    { … }
  ],
  "payment": {
    "uri": "https://payments.frubipay.com/1234567890",
    "status": "Pending",
    "method": { … }
  }
}