Cancel Partial Order
Use the Cancel a partial order endpoint to cancel specific line items within an order, leaving the remaining line items active.
POST /order/cancel-items
This is useful when a customer needs to return only some of their tickets — for example, reducing a group booking or cancelling seats for attendees who can no longer attend, without affecting the rest of the order.
Cancelled line items are released back to the available inventory pool. The order remains active for any line items not included in the cancellation request.
Required fields
At least one order identifier must be provided. If both are supplied, orderLocatorId takes precedence.
Field | Type | Required | Description |
|---|---|---|---|
| string | Yes | The Ticketmaster event ID associated with the order. |
| string | Conditional | Your system's order ID, as submitted when the order was created. Required if |
| string | Conditional | The Ticketmaster order ID returned when the order was created. Required if |
| array of strings | Yes | The |
Successful response
A successful response (HTTP 200) returns the updated order. The lineItems array reflects the final state of all line items — both those that were cancelled and those that remain active. Verify that the line items you requested to cancel now show a status of CANCELED, and that the remaining line items show ACTIVE.
Handling errors
HTTP status | What it means |
|---|---|
400 | The request body is invalid. Check the |
403 | The API key is missing or invalid. |
404 | No order was found matching the identifiers provided. Verify the |
422 | The partial cancellation could not be processed. Check the |
500 | An unexpected error occurred. Include the |
On this page
- Cancel Partial Order
