Inventory / Bulk Update

Name	Inventory / Bulk Update
Description	Update Inventory Ticket Listings in Bulk
Type	`PATCH`
URL	`/v9/inventory`
Credential Type	`APICredential\|UserCredential`

Long Description:

Update the same attributes on up to 1000 listings. All parameters are optional unless otherwise specified. Any optional parameters that are provided with a blank value (e.g. ”” ) will result in a validation error. Most attributes that are available on Inventory / Update are be supported, but notably there are some attributes that are not allowed.

remote_id - Needs to be unique across all inventory
quantity - adjusts the seats underneath a group, and we don’t know which ones to remove, or have enough information to add more
seats - seat numbers, barcodes, and other seat items are unique

If you. need to adjust any of these items, you must do so using the Inventory / Update endpoint.

Request Parameters

Json Body

Attribute Name	Type	Required

Attribute Name	Type	Required
`ids`	Array of Ticket Group IDs	Yes
`inventory`	Inventory Object with attributes to apply to all Ticket Groups	Yes

Inventory Object

Attribute Name	Type	Required	Notes

Attribute Name	Type	Required	Notes
`account_email`	String	No	Email format
`cost`	Float	No
`discount`	Float	No	Acceptable values between 0.00 and 100.00
`eticket`	Boolean	No
`external_notes`	String	No
`face_value`	Decimal	No
`format`	String (Enum)	No	Acceptable Values: Eticket Flash_seats Guest_list Paperless Physical TM_mobile
`in_hand`	Boolean	No
`in_hand_on`	String (Date)	Conditional	Required when `in_hand` is `false` or not provided
`instant_delivery`	Boolean	No
`internal_notes`	String	No
`price`	Decimal	No	Maximum value is 1,000,000
`row`	String	No
`section`	String	No
`speculative`	Boolean	No
`split_type`	String (Enum)	No	Acceptable Values: `DEFAULT` `ANY` `NEVERLEAVEONE` `NONE` `CUSTOM`
`split_override`	Array of Integers	Conditional	Required if `split_type` is `CUSTOM`
`taxed_cost`	Float	No
`type`	String (Enum)	No	Acceptable Values: `EVENT` `PARKING`
`view_type`	String (Enum)	No	Acceptable Values: `Full` `Obstructed` `Possibly Obstructed` `Partially Obstructed`
`wheelchair_accessible`	Boolean	No

Responses

HTTP Code	Meaning	Description

HTTP Code	Meaning	Description
200	OK	All inventory was successfully updated. Response body contains updated item payloads.
400	Bad Request	Validation error. Check input fields and formats. A detailed error message is included in the response body.
401	Unauthorized	Authentication failed or missing credentials.
404	Not Found	Resource not found for any of the provided identifiers.
500	Internal Server Error	An unexpected error occurred on the server.

Examples:

Request	Response

Request	Response
PATCH /v9/inventory `{ "ids": [12345,23456,34567,45678,56789], "inventory": { "price": "100.00" } }` Note: All ticket group ids passed exist on the marketplace	Success `{ "inventory": { ... "id": "12345", "price": "100.00", ... }, { ... "id": "23456" "price": "100.00", ... }, { ... "id": "34567" "price": "100.00", ... }, { ... "id": "45678" "price": "100.00", ... }, { ... "id": "56789" "price": "100.00", ... } }`
PATCH /v9/inventory `{ "ids": [12345,23456,34567,45678,56789], "inventory": { "price": "100.00" } }` Note: Only some of the ticket group ids passed exist. The returned items are the ones that existed, and were updated.	Success `{ "inventory": { { ... "id": "23456" "price": "100.00", ... }, { ... "id": "45678" "price": "100.00", ... } }`
PATCH /v9/inventory `{ "ids": [12345,23456,34567,45678,56789], "inventory": { "price": "100.00" } }` Note: None of the ticket group ids passed exist, so a 404 is returned.	Error (404) `{ "errors": [ { "code": "not_found", "message":"Could not find record." } ] }`
Bad Request Example `{ "ids": ["foo",12345,23456,34567,45678,56789], "inventory": { "price": "100.00" } }` Note: None of the valid ticket group ids passed are updated on any 4xx error.	Error (400) `{ "errors": [ { "code": "invalid_params", "message": "ids[0] must be an integer" } ] }`