REST API: Requesting a Ticket for an Event

In order to purchase a ticket, you must first reserve your seat. You reserve a seat by making a PUT request to the reservations Resource URI. The system will asynchronously processes all reservations in a first come, first serve basis. The system will return a SeatReservationResponse. It contains an IsComplete and

Resource URI
{webKey}/orders/{orderID}/reservations
Parameters
Parameter Description
WebKey The system assigned key to the account that is selling tickets to the event.
ReservationID The ID of the order that will contain the ticket reservations.
Portal A string value of the portal used to place the order. Valid values are WebSite, WalkUp, Phone, HouseComp, GuestList, CallCenter. This parameter is optional.

Example 1

This will attempt to reserve 3 of the best seats available for event 158265 for order fe5e60c8-11e0-47dc-97c4-b36365706801. In order to determine the
best available key, the PriceTiers were retrieved for the event. The Best Available PriceTierGroup can be determined by selecting the first group with the following
properties and values:

Property Value
SystemGroup true
Title Best Available
curl -X PUT -H "Content-Type: application/json" -d '{ 
  "EventID": 42527,
  "PriceTiers": [
    { 
      "Key": "AAEAAAD/////AQAAAAAAAAAMAgAAAE5UaWNrZXRCaXNjdWl0LkNvcmUsIFZlcnNpb249MjAxMy4yMjYuMC4wLCBDdWx0dXJlPW5ldXRyYWwsIFB1YmxpY0tleVRva2VuPW51bGwMAwAAAE1CaXNjdWl0QnJhaW4uQ29yZSwgVmVyc2lvbj0yMDEzLjIyNi4wLjAsIEN1bHR1cmU9bmV1dHJhbCwgUHVibGljS2V5VG9rZW49bnVsbAUBAAAAH1RpY2tldEJpc2N1aXQuVGlja2V0cy5QcmljZVRpZXIHAAAAHDxEZXNjcmlwdGlvbj5rX19CYWNraW5nRmllbGQaPFBhc3N3b3Jkcz5rX19CYWNraW5nRmllbGQWPFByaWNlPmtfX0JhY2tpbmdGaWVsZCA8VGlja2V0c1Blck9yZGVyPmtfX0JhY2tpbmdGaWVsZBU8VGV4dD5rX19CYWNraW5nRmllbGQWPFRpdGxlPmtfX0JhY2tpbmdGaWVsZBo8QXZhaWxhYmxlPmtfX0JhY2tpbmdGaWVsZAEDAwQBAQMPU3lzdGVtLlN0cmluZ1tdcFN5c3RlbS5OdWxsYWJsZWAxW1tTeXN0ZW0uRGVjaW1hbCwgbXNjb3JsaWIsIFZlcnNpb249NC4wLjAuMCwgQ3VsdHVyZT1uZXV0cmFsLCBQdWJsaWNLZXlUb2tlbj1iNzdhNWM1NjE5MzRlMDg5XV3TAUJpc2N1aXRCcmFpbi5SYW5nZWAxW1tTeXN0ZW0uTnVsbGFibGVgMVtbU3lzdGVtLkludDMyLCBtc2NvcmxpYiwgVmVyc2lvbj00LjAuMC4wLCBDdWx0dXJlPW5ldXRyYWwsIFB1YmxpY0tleVRva2VuPWI3N2E1YzU2MTkzNGUwODldXSwgbXNjb3JsaWIsIFZlcnNpb249NC4wLjAuMCwgQ3VsdHVyZT1uZXV0cmFsLCBQdWJsaWNLZXlUb2tlbj1iNzdhNWM1NjE5MzRlMDg5XV0DAAAAblN5c3RlbS5OdWxsYWJsZWAxW1tTeXN0ZW0uSW50MzIsIG1zY29ybGliLCBWZXJzaW9uPTQuMC4wLjAsIEN1bHR1cmU9bmV1dHJhbCwgUHVibGljS2V5VG9rZW49Yjc3YTVjNTYxOTM0ZTA4OV1dAgAAAAoJBAAAAAoJBQAAAAoKChEEAAAAAAAAAAUFAAAA0wFCaXNjdWl0QnJhaW4uUmFuZ2VgMVtbU3lzdGVtLk51bGxhYmxlYDFbW1N5c3RlbS5JbnQzMiwgbXNjb3JsaWIsIFZlcnNpb249NC4wLjAuMCwgQ3VsdHVyZT1uZXV0cmFsLCBQdWJsaWNLZXlUb2tlbj1iNzdhNWM1NjE5MzRlMDg5XV0sIG1zY29ybGliLCBWZXJzaW9uPTQuMC4wLjAsIEN1bHR1cmU9bmV1dHJhbCwgUHVibGljS2V5VG9rZW49Yjc3YTVjNTYxOTM0ZTA4OV1dAgAAAB48U3RhcnRpbmdWYWx1ZT5rX19CYWNraW5nRmllbGQcPEVuZGluZ1ZhbHVlPmtfX0JhY2tpbmdGaWVsZAMDblN5c3RlbS5OdWxsYWJsZWAxW1tTeXN0ZW0uSW50MzIsIG1zY29ybGliLCBWZXJzaW9uPTQuMC4wLjAsIEN1bHR1cmU9bmV1dHJhbCwgUHVibGljS2V5VG9rZW49Yjc3YTVjNTYxOTM0ZTA4OV1dblN5c3RlbS5OdWxsYWJsZWAxW1tTeXN0ZW0uSW50MzIsIG1zY29ybGliLCBWZXJzaW9uPTQuMC4wLjAsIEN1bHR1cmU9bmV1dHJhbCwgUHVibGljS2V5VG9rZW49Yjc3YTVjNTYxOTM0ZTA4OV1dAwAAAAoKCw==",
      "Value": 3 
    }
  ]
}' http://api.branch.corp.ticketbiscuit.com/TicketBiscuit/orders/fe5e60c8-11e0-47dc-97c4-b36365706801/reservations 
{
	"SeatReservations": {
		"42527": {
			"Created": "2013-05-01T05:16:52.374601Z",
			"EventID": 42527,
			"Expires": "2013-05-01T05:26:52.374601Z",
			"ID": "aa2bf4cd-aa09-4055-8613-0caf5203619b",
			"IsComplete": false,
			"Message": null,
			"Processed": null,
			"Queued": null,
			"QueueIndex": 0,
			"RequestedQuantity": 3,
			"ReservationEngineID": "a36d9350-779a-44a3-bd5a-88639fb10c98",
			"Tickets": [],
			"WasSuccessful": false
		}
	},
	"Expires": "0001-01-01T00:00:00",
	"Created": "2013-05-01T05:16:52.374601Z",
	"ID": "fe5e60c8-11e0-47dc-97c4-b36365706801",
	"IsComplete": false,
	"Message": null
}
curl http://api.branch.corp.ticketbiscuit.com/TicketBiscuit/orders/fe5e60c8-11e0-47dc-97c4-b36365706801/reservations/status	
{
    "SeatReservations": {
        "42527": {
            "Created": "2013-04-16T17:49:01.6924983Z",
            "EventID": 42527,
            "Expires": "2013-04-16T17:53:57.1297397Z",
            "ID": "06c251b7-68c5-486a-b2ec-69d4968cf9df",
            "IsComplete": true,
            "Message": null,
            "Processed": "2013-04-16T17:49:03.1297397Z",
            "Queued": "2013-04-16T17:49:01.8021358Z",
            "QueueIndex": 3,
            "RequestedQuantity": 3,
            "ReservationEngineID": "4180ed8c-0a1c-44dd-8db9-583dc4048254",
            "Tickets": [
                {
                    "EventID": 42527,
                    "Code": null,
                    "ID": "fe5e60c8-11e0-47dc-97c4-b36365706801",
                    "Number": 0,
                    "UserID": 0,
                    "Holder": null,
                    "Seat": {
                        "ID": 897366,
                        "Section": {
                            "ID": 825,
                            "Title": "Section 10 A-31",
                            "Description": null,
                            "Entrance": null,
                            "IsGeneralAdmission": false
                        },
                        "Title": "24",
                        "GroupID": "21"
                    },
                    "LegacyTicketProductID": "86d2f7c4-a92b-4618-8d5a-8d47a580314d",
                    "Redemption": null,
                    "Printed": null,
                    "OrderID": "fe5e60c8-11e0-47dc-97c4-b36365706801",
                    "Canceled": null,
                    "Created": "2013-04-16T17:49:03.1297397Z",
                    "Delivery": null,
                    "Description": null,
                    "BasePrice": 25,
                    "SalesTaxMethod": 2,
                    "SalesTaxRate": 0.1,
                    "Fees": [
                        {
                            "FeeType": 1,
                            "OrderMethod": 0,
                            "Description": null,
                            "Amount": 4
                        }
                    ]
                },
                {
                    "EventID": 42527,
                    "Code": null,
                    "ID": "fe5e60c8-11e0-47dc-97c4-b36365706801",
                    "Number": 0,
                    "UserID": 0,
                    "Holder": null,
                    "Seat": {
                        "ID": 859119,
                        "Section": {
                            "ID": 825,
                            "Title": "Section 10 A-31",
                            "Description": null,
                            "Entrance": null,
                            "IsGeneralAdmission": false
                        },
                        "Title": "23",
                        "GroupID": "21"
                    },
                    "LegacyTicketProductID": "86d2f7c4-a92b-4618-8d5a-8d47a580314d",
                    "Redemption": null,
                    "Printed": null,
                    "OrderID": "fe5e60c8-11e0-47dc-97c4-b36365706801",
                    "Canceled": null,
                    "Created": "2013-04-16T17:49:03.1297397Z",
                    "Delivery": null,
                    "Description": null,
                    "BasePrice": 25,
                    "SalesTaxMethod": 2,
                    "SalesTaxRate": 0.1,
                    "Fees": [
                        {
                            "FeeType": 1,
                            "OrderMethod": 0,
                            "Description": null,
                            "Amount": 4
                        }
                    ]
                },
                {
                    "EventID": 42527,
                    "Code": null,
                    "ID": "fe5e60c8-11e0-47dc-97c4-b36365706801",
                    "Number": 0,
                    "UserID": 0,
                    "Holder": null,
                    "Seat": {
                        "ID": 881824,
                        "Section": {
                            "ID": 825,
                            "Title": "Section 10 A-31",
                            "Description": null,
                            "Entrance": null,
                            "IsGeneralAdmission": false
                        },
                        "Title": "22",
                        "GroupID": "21"
                    },
                    "LegacyTicketProductID": "86d2f7c4-a92b-4618-8d5a-8d47a580314d",
                    "Redemption": null,
                    "Printed": null,
                    "OrderID": "fe5e60c8-11e0-47dc-97c4-b36365706801",
                    "Canceled": null,
                    "Created": "2013-04-16T17:49:03.1297397Z",
                    "Delivery": null,
                    "Description": null,
                    "BasePrice": 25,
                    "SalesTaxMethod": 2,
                    "SalesTaxRate": 0.1,
                    "Fees": [
                        {
                            "FeeType": 1,
                            "OrderMethod": 0,
                            "Description": null,
                            "Amount": 4
                        }
                    ]
                }
            ],
            "WasSuccessful": true
        }
    },
    "Expires": "2013-04-16T17:53:57.1297397Z",
    "Created": "2013-04-16T17:23:43.1490442Z",
    "ID": "fe5e60c8-11e0-47dc-97c4-b36365706801",
    "IsComplete": false,
    "Message": null
}