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.

NameDescriptionTypeAdditional 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": "2019-03-19T17:00",
    "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": "2019-03-19T17:00",
      "Note": ""
    },
    "CustomItems": [
      {
        "Description": "",
        "Amount": 2.0
      }
    ],
    "PaymentDetails": [
      {
        "PaymentModeId": "",
        "PaymentDate": "2019-03-19T17:00",
        "Amount": {
          "Currency": "",
          "Amount": 1.0
        },
        "ReferenceNo": "",
        "Note": ""
      }
    ]
  },
  "SpecOption": {
    "ExpirationType": "Never",
    "ExpirationDate": "2019-03-19T17:00",
    "ExpirationDays": 1
  },
  "IsSpecInventory": true,
  "IsLiteTicket": true,
  "Tickets": [
    {
      "SHEventId": 1,
      "EventId": "",
      "VenueId": "",
      "Event": "",
      "EventDate": "2019-03-19T17:00",
      "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
          }
        }
      ],
      "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": "2019-03-19T17:00"
      },
      "DeliveryOption": "Any",
      "ReferenceNumber": "",
      "FacePrice": {
        "Currency": "",
        "Amount": 1.0
      },
      "PurchasePrice": {
        "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

NameDescriptionTypeAdditional 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": "2019-03-19T17:00",
        "OriginalEventDate": "2019-03-19T17:00",
        "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": "2019-03-19T17:00",
        "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
            }
          }
        ],
        "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": "2019-03-19T17:00"
        },
        "DeliveryOption": "Any",
        "ReferenceNumber": "",
        "FacePrice": {
          "Currency": "",
          "Amount": 1.0
        },
        "PurchasePrice": {
          "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": ""
      }
    }
  ]
}