POST POS/v3.1/Tickets Try Now
This is all or nothing add tickets operation. If an error occurs while adding tickets then none of the tickets will be added and all the failed tickets along with their index and error message will be returned in the response.
Request Information
URI Parameters
None.
Body Parameters
The request.
| Name | Description | Type | Additional information |
|---|---|---|---|
| PurchaseOrder |
The purchase order.
|
PurchaseOrderDetails |
Optional - Only Required for POS Plus Account where Purchase Order is created while adding Tickets
|
| SpecOption |
The spec option.
|
SpecDetails |
Conditional - Only Required when IsSpecInventory flag is true
|
| IsSpecInventory |
Indicating whether the ticket is spec inventory.
|
boolean |
Optional - Only Required if trying to create spec inventory
|
| IsLiteTicket | boolean |
Optional - Reserved for Internal Purpose Only. Should not be implemented
|
|
| Tickets |
Ticket details. (Only 300 Ticket Groups can be added per API request)
|
Collection of TicketDetails |
None.
|
| Broadcast |
Broadcast Details.
|
BroadcastDetails |
Required
|
Request Formats
application/json, text/json
Sample:
{
"PurchaseOrder": {
"Currency": "",
"PODate": "2024-11-28T02:24",
"ShipFromContactId": "",
"BillToAddressId": "",
"ShipToAddressId": "",
"VendorCSRId": "",
"SubscriberCSRId": "",
"POType": "Any",
"Consignment": {
"Operation": "Any",
"Commission": 1.0
},
"ExternalOrderNumber": "",
"Notes": "",
"IsShippingCostIncludedinTicketPrice": true,
"Shipping": {
"Cost": 1.0,
"TrackingNumber": "",
"Service": "",
"Carrier": "None",
"Type": "None",
"DateExpected": "2024-11-28T02:24",
"Note": ""
},
"CustomItems": [
{
"Description": "",
"Amount": 2.0
}
],
"PaymentDetails": [
{
"PaymentModeId": "",
"PaymentDate": "2024-11-28T02:24",
"Amount": {
"Currency": "",
"Amount": 1.0
},
"ReferenceNo": "",
"Note": ""
}
]
},
"SpecOption": {
"ExpirationType": "Never",
"ExpirationDate": "2024-11-28T02:24",
"ExpirationDays": 1
},
"IsSpecInventory": true,
"IsLiteTicket": true,
"Tickets": [
{
"SHEventId": 1,
"EventId": "",
"VenueId": "",
"Event": "",
"EventDate": "2024-11-28T02:24",
"Venue": "",
"Section": "",
"Row": "",
"Quantity": 9,
"MaskedQuantity": 10,
"DoNotWaste": true,
"Seating": "Any",
"Stock": "Any",
"SHDeliveryMethod": "None",
"PredeliverToSH": true,
"TicketSeats": [
{
"Seat": 1,
"Barcode": "",
"ReferenceNumber": 3,
"UniqueTicketNumber": "",
"FacePrice": {
"Currency": "",
"Amount": 1.0
},
"InventoryType": ""
}
],
"TicketTraits": [
{
"StubHubTraitId": 1,
"Description": "",
"Seat": 3
}
],
"RestrictionOption": "None",
"PublicNotes": "",
"InternalNotes": "",
"BrokerNotes": "",
"ControlNotes": "",
"SplitOptions": {
"SplitOption": "None",
"Splits": 1,
"OverrideSplitOption": true
},
"ConnectedStatus": "Any",
"InHandDetails": {
"InHandStatus": "Any",
"InHandDays": 1,
"InHandDate": "2024-11-28T02:24"
},
"DeliveryOption": "Any",
"ReferenceNumber": "",
"FacePrice": {
"Currency": "",
"Amount": 1.0
},
"PurchasePrice": {
"Currency": "",
"Amount": 1.0
},
"TaxedCost": {
"Currency": "",
"Amount": 1.0
},
"SellPrice": {
"Currency": "",
"Amount": 1.0
},
"Discount": 17.0,
"Overs": 18.0,
"Tax": 19.0,
"Tags": [
""
],
"MinimumPayout": 20.0,
"HideSeats": true,
"ZonePricing": "",
"IsFacePriceSameforSeats": true,
"Location": ""
}
],
"Broadcast": {
"BroadcastTo": "Default",
"Zones": [
{
"ZoneCode": "Any",
"Broadcast": true
}
]
}
}
Response Information
Resource Description
| Name | Description | Type | Additional information |
|---|---|---|---|
| PurchaseOrderId |
The purchase order identifier.
|
string |
None.
|
| PurchaseOrderNumber |
The purchase order number.
|
long |
None.
|
| Tickets |
The tickets.
|
Collection of TicketDetails |
None.
|
| Status | BulkActionStatus |
None.
|
|
| Errors | Collection of TicketDetails |
None.
|
Response Formats
application/json, text/json
Sample:
{
"PurchaseOrderId": "",
"PurchaseOrderNumber": 2,
"Tickets": [
{
"TicketGroupId": "",
"TicketNumber": 2,
"ReferenceNumber": "",
"EventDetails": {
"EventName": "",
"OriginalEventName": "",
"VenueName": "",
"OriginalVenueName": "",
"EventDate": "2024-11-28T02:24",
"OriginalEventDate": "2024-11-28T02:24",
"EventId": "",
"VenueId": ""
},
"Seats": [
{
"SeatId": "",
"Seat": 2,
"Barcode": "",
"ReferenceNumber": 4,
"FacePrice": {
"Currency": "",
"Amount": 1.0
},
"UniqueTicketNumber": ""
}
],
"Seating": "Any",
"PurchaseOrderItemId": "",
"HighSeat": 5,
"LowSeat": 6,
"Section": "",
"Row": "",
"Stock": "Any",
"TicketStatus": "Any",
"SHDeliveryMethod": "None",
"PredeliverToSH": true,
"DeliveryOption": "Any",
"HideSeats": true
}
],
"Status": "Success",
"Errors": [
{
"ErrorMessage": "",
"Item": {
"SHEventId": 1,
"EventId": "",
"VenueId": "",
"Event": "",
"EventDate": "2024-11-28T02:24",
"Venue": "",
"Section": "",
"Row": "",
"Quantity": 9,
"MaskedQuantity": 10,
"DoNotWaste": true,
"Seating": "Any",
"Stock": "Any",
"SHDeliveryMethod": "None",
"PredeliverToSH": true,
"TicketSeats": [
{
"Seat": 1,
"Barcode": "",
"ReferenceNumber": 3,
"UniqueTicketNumber": "",
"FacePrice": {
"Currency": "",
"Amount": 1.0
},
"InventoryType": ""
}
],
"TicketTraits": [
{
"StubHubTraitId": 1,
"Description": "",
"Seat": 3
}
],
"RestrictionOption": "None",
"PublicNotes": "",
"InternalNotes": "",
"BrokerNotes": "",
"ControlNotes": "",
"SplitOptions": {
"SplitOption": "None",
"Splits": 1,
"OverrideSplitOption": true
},
"ConnectedStatus": "Any",
"InHandDetails": {
"InHandStatus": "Any",
"InHandDays": 1,
"InHandDate": "2024-11-28T02:24"
},
"DeliveryOption": "Any",
"ReferenceNumber": "",
"FacePrice": {
"Currency": "",
"Amount": 1.0
},
"PurchasePrice": {
"Currency": "",
"Amount": 1.0
},
"TaxedCost": {
"Currency": "",
"Amount": 1.0
},
"SellPrice": {
"Currency": "",
"Amount": 1.0
},
"Discount": 17.0,
"Overs": 18.0,
"Tax": 19.0,
"Tags": [
""
],
"MinimumPayout": 20.0,
"HideSeats": true,
"ZonePricing": "",
"IsFacePriceSameforSeats": true,
"Location": ""
}
}
]
}