Cart Test
Web/Cart/{sessionKey}/Tickets
Reserves tickets in cart

Adds a seated or unseated performance line item to the cart and reserves seats using either the best seat function or reserves specific seats.

This method will allow the reservation of held seats.To enable this functionality, add the key ''Reserve Held Seats' to T_DEFAULTS with a value of 'Yes' under the "Tessitura Web" parent table (or organization name if operating in a consortium environment).
Http Verb POST
Resource URL https://ts-stg-appgw.calacademy.org/TessituraService/Web/Cart/{sessionKey}/Tickets

URI Parameters

Parameter Name Data Type Required Notes
sessionKey string Y

Request Body

Request object type : ReserveTicketsRequest

Request object type ReserveTicketsRequest has the following properties.
Property Name Data Type Length Required Readonly Notes
NumberOfSeats integer N The number of seats to be added to the cart for the request. Not required if specific seats are specified in the RequestedSeats property.
PerformanceId integer Y The ID of the performance number to be added to the cart.
FK: T_PERF.perf_no   Resource: Performances
PriceType string Y The price type for the performance. If multiple seats are being requested different price types can be used for each seat by passing a comma separated list of price types. When using multiple price types, a price type must be specified for each seat even if some seats are using the same price type.For example, if there are 4 seats, two at the Adult and two at the Child price type, 4 price type IDs must be passed. The price types passed must be valid for the current mode of sale.
FK: TR_PRICE_TYPE.id   Resource: PriceTypes
PriceTypeReason string N Price Type reasons (Comp Codes) for use with price types that require them. If multiple seats are being requested with different price types, the price type reasons can be specified in a list, matching the price types.
FK: TR_COMP_CODE.id   Resource: PriceTypeReasons
RequestedSeats string N The ID numbers (seat_no) of specific seats to reserve. Muliple seat numbers can be passed as a comma separated list. Seats must be in the specificed performance and available.
SpecialRequests string Used to refine which seats are selected by the best seat function (including reserving seats held with a hold code). Special requests are passed as a string of name-value pairs formatted as follows: name1=value1andname2=value2. See the special requests section for valid special request names and values.
Unseated boolean N If True, the tickets will be added to the cart unseated.
ZoneId integer Y The ID number of the desired price zone for the request. A value of 0 can be passed When reserving specific seats, the zone of the specified seats overrides whatever zone value is passed here.As the parameter is required but essentially irrelevant, you can pass a value of 0 to meet the requirement.
FK: T_ZONE.zone_no   Resource: Zones 
{
  "PriceType": "sample string 1",
  "PriceTypeReason": "sample string 2",
  "PerformanceId": 3,
  "NumberOfSeats": 4,
  "ZoneId": 5,
  "SpecialRequests": "sample string 6",
  "Unseated": true,
  "RequestedSeats": "sample string 8"
}
<ReserveTicketsRequest xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <NumberOfSeats>4</NumberOfSeats>
  <PerformanceId>3</PerformanceId>
  <PriceType>sample string 1</PriceType>
  <PriceTypeReason>sample string 2</PriceTypeReason>
  <RequestedSeats>sample string 8</RequestedSeats>
  <SpecialRequests>sample string 6</SpecialRequests>
  <Unseated>true</Unseated>
  <ZoneId>5</ZoneId>
</ReserveTicketsRequest>

Response object type : ReserveTicketsResponse

Response object type ReserveTicketsResponse has the following properties.
Property Name Data Type Length Required Readonly Notes
LineItemId integer
SeatsReserved integer 
{
  "LineItemId": 1,
  "SeatsReserved": 2
}
<ReserveTicketsResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <LineItemId>1</LineItemId>
  <SeatsReserved>2</SeatsReserved>
</ReserveTicketsResponse>
Change Version Description Contract Old New
Parameter Changed 15.0.0 sessionKey has been marked as required. Required