Create an Order
Use the Create an order endpoint to submit a ticket order against your allocation for a given event.
POST /order
Orders are synchronous — a successful response (HTTP 201) means the order has been confirmed in the Ticketmaster system. If the request cannot be fulfilled, the API returns a structured error response explaining the reason.
Order types
The API supports three order types, determined by the isGeneralAdmission flag on each line item:
Type | Description |
|---|---|
GA (General Admission) | Set |
Fixed | Set |
Mixed | An order containing a combination of GA and fixed-seat line items. |
Required fields
Field | Type | Description |
|---|---|---|
| string | The Ticketmaster event ID from your allocation. The eventId returned by Get allocated events for the show you are selling. We cannot check that it is the show you intended, so confirm the event name, venue and start time with Get a single event allocation before you submit. |
| string | Your system's unique identifier for this order. Used to look up or cancel the order later. Must be unique per event. |
| object | Details of the customer who placed the order on your platform. See the customer object below. |
| array | One or more ticket line items. See the line item object below. |
Customer object
Field | Type | Required | Description |
|---|---|---|---|
| string | No | Customer's first name. |
| string | No | Customer's last name. |
| string | Yes | Customer's email address. |
| string | Yes | Customer's phone number, including country code (e.g. |
Line item object
Each entry in the lineItems array represents one ticket.
Field | Type | Required | Description |
|---|---|---|---|
| string | Yes | Your unique ID for this line item. Must be unique within the order. Recommended pattern: |
| string | Yes | The offer ID from your allocation for this seat or section. |
| string | Conditional | The ticket type ID from your allocation (e.g. |
| boolean | No | Set to |
| string | Yes | The section identifier from your allocation. |
| string | Fixed only | The row identifier. Required when |
| string | Fixed only | The seat number. Required when |
| number | Yes | Ticket face value multiplied by 100. For example, |
| number | Yes | Number of decimal places for the currency. Use |
| string | Yes | ISO 4217 currency code (e.g. |
Handling errors
HTTP status | Error code | What it means |
|---|---|---|
400 | — | The request body is invalid. Check the |
409 | — | An order with the same |
422 |
| The specific seat requested is no longer available. Refresh your allocation and select a different seat. |
422 |
| There is insufficient GA inventory to fulfil the requested quantity. |
404 |
| We could not find inventory for this event. Check the |
422 |
| The order cutoff time for this event has passed and orders are no longer accepted. |
422 |
| The |
422 |
| The Ticketmaster booking system is temporarily unavailable. Retry after a short delay. |
For all 422 errors, check the additionalErrorMessage field for more detail. Include the cid (correlation ID) from the response when contacting Ticketmaster support.
On this page
- Create an Order
