{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/api/booking-flow/product/quantities/","matchPath":"","result":{"data":{"markdownRemark":{"html":"

Quantities

\n

When customers select a ticket holder, there may be limits on bookable quantities. These limits may exist for both the timeslot and the ticket holder (formally known as the product). Both sets of limits should be observed in order to provide a smooth customer experience.

\n

Timeslot

\n

At the timeslot level, quantity limits restrict the total number of products which can be added to cart for that specific date/time. There are three properties which describe a timeslot's quantity limits.

\n

max_buy

\n

This property is the maximum quantity you are allowed to add to cart for the timeslot. Its value is based on sales restrictions (if any) and remaining seats from the availability property.

\n

When the value is zero, the timeslot is no longer available and its products cannot be added to cart.

\n

When the value is greater than zero, the total quantity for products added to cart must be less than or equal to this value.

\n

A value of -1 means the timeslot has no maximum quantity requirement.

\n

min_buy

\n

This property is the minimum quantity a timeslot must have if you want to add to cart. The total quantity for products added to cart must be greater than or equal to this value.

\n

availability

\n

While min_buy and max_buy impose quantity limits for the timeslot, the availability property displays the total number of remaining seats for the timeslot.

\n

A value of -1 means the number of remaining seats has not been specified for the timeslot.

\n

Ticket holder (product)

\n

At the ticket holder level (formally known as the product), quantity limits apply to the specific product you want to add to cart. These may differ from the timeslot restrictions. There are three properties which describe a product's quantity limits.

\n

max_buy

\n

This property refers to the maximum quantity of a product you are allowed to add to cart. Its value is based on sales restrictions (if any) and remaining seats from the availability property.

\n

When the value is zero, then the product is no longer available and cannot be added to cart.

\n

When the value is greater than zero, the total quantity for products added to cart must be less than or equal to this value.

\n

min_buy

\n

This property refers to the minimum quantity a product must have if you want to add it to cart.

\n

availability

\n

While min_buy and max_buy impose quantity limits, the availability property refers to the number of remaining seats for an individual product.

\n

A value of -1 means the number of remaining seats has not been specified for the product.

\n

Examples

\n

Timeslot with limits

\n

In the example response below, the timeslot has no specified minimum and permits a maximum of 20 seats:

\n
\n
\n
Copy
\n
Copied
\n
\n 
{\n\t\"groups\": [\n\t\t{\n\t\t\t[...]\n\t\t\t\"slots\": [\n\t\t\t\t{\n\t\t\t\t\t[...]\n\t\t\t\t\t\"min_buy\": 1,\n\t\t\t\t\t\"max_buy\": 20,\n\t\t\t\t\t\"availability\": 20,\n\t\t\t\t\t\"products\": [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t[...]\n\t\t\t\t\t\t\t\"name\": \"Adult (8+)\",\n\t\t\t\t\t\t\t\"min_buy\": 1,\n\t\t\t\t\t\t\t\"max_buy\": 15,\n\t\t\t\t\t\t\t\"availability\": -1,\n\t\t\t\t\t\t\t[...]\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t[...]\n\t\t\t\t\t\t\t\"name\": \"Child (3-7)\",\n\t\t\t\t\t\t\t\"min_buy\": 1,\n\t\t\t\t\t\t\t\"max_buy\": 15,\n\t\t\t\t\t\t\t\"availability\": -1,\n\t\t\t\t\t\t\t[...]\n\t\t\t\t\t\t}\n\t\t\t\t\t]\n\t\t\t\t}\n\t\t\t]\n\t\t}\n\t]\n}
\n
\n

In the same example, the number of remaining seats per product is not specified. Customers can add any combination of the product quantities, provided their total quantity is not more than 20 and their individual quantities are not more than 15.

\n

Timeslot with no limits

\n

In the example response below, there are no timeslot limits and the one available product requires a quantity of at least two in order to be added to cart:

\n
\n
\n
Copy
\n
Copied
\n
\n 
{\n\t\"groups\": [\n\t\t{\n\t\t\t[...]\n\t\t\t\"slots\": [\n\t\t\t\t{\n\t\t\t\t\t[...]\n\t\t\t\t\t\"min_buy\": 1,\n\t\t\t\t\t\"max_buy\": -1,\n\t\t\t\t\t\"availability\": -1,\n\t\t\t\t\t\"products\": [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t[...]\n\t\t\t\t\t\t\t\"min_buy\": 2,\n\t\t\t\t\t\t\t\"max_buy\": 12,\n\t\t\t\t\t\t\t\"availability\": 12,\n\t\t\t\t\t\t\t[...]\n\t\t\t\t\t\t}\n\t\t\t\t\t]\n\t\t\t\t}\n\t\t\t]\n\t\t}\n\t]\n}
\n
\n

In the same example, while there is no maximum for the timeslot, the product imposes a maximum of 12. Any attempt to add a quantity greater than 12 will fail.

","headings":[{"value":"Quantities","depth":1},{"value":"Timeslot","depth":2},{"value":"max_buy","depth":3},{"value":"min_buy","depth":3},{"value":"availability","depth":3},{"value":"Ticket holder (product)","depth":2},{"value":"max_buy","depth":3},{"value":"min_buy","depth":3},{"value":"availability","depth":3},{"value":"Examples","depth":2},{"value":"Timeslot with limits","depth":3},{"value":"Timeslot with no limits","depth":3}]},"contentItem":{"data":{"lastModified":"2025-12-18T16:31:42.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":false,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"68280de3-6a7c-5efb-aa07-b93f005013d1__redocly content/api/booking-flow/product/quantities/","seo":{"title":"Quantities","description":"Customers must select a quantity within specified bounds as part of the Musement API booking flow.","image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"api/booking-flow/product/quantities.md","pageBaseUrl":"/api/booking-flow/product/quantities","type":"markdown","toc":{"enable":true,"maxDepth":2,"headings":[{"depth":1,"value":"Quantities","id":"quantities"},{"depth":2,"value":"Timeslot","id":"timeslot"},{"depth":3,"value":"max_buy","id":"max_buy"},{"depth":3,"value":"min_buy","id":"min_buy"},{"depth":3,"value":"availability","id":"availability"},{"depth":2,"value":"Ticket holder (product)","id":"ticket-holder-product"},{"depth":3,"value":"max_buy","id":"max_buy-1"},{"depth":3,"value":"min_buy","id":"min_buy-1"},{"depth":3,"value":"availability","id":"availability-1"},{"depth":2,"value":"Examples","id":"examples"},{"depth":3,"value":"Timeslot with limits","id":"timeslot-with-limits"},{"depth":3,"value":"Timeslot with no limits","id":"timeslot-with-no-limits"}]},"data":{"title":"","redirectFrom":["/guide/availability/quantity-limits/","/api/partner/booking-flow/product/quantity-limits/","/api/partner/booking-flow/product/quantities/"],"seo":{"description":"Customers must select a quantity within specified bounds as part of the Musement API booking flow."},"toc":{"maxDepth":2}},"catalogInfo":null,"link":"/api/booking-flow/product/quantities/","sidebarName":"__alternative-sidebar__-data-24763-api-sidebars.yaml","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}