Get Tickets Endpoint
The get ticket endpoint will allow resellers to retrieve listing information for their exchange.
The results can be filtered and paginated. The response will return all Tixstock listings assigned to the reseller regardless whether it's published status. Please be aware that results can include listings without an ID assigned due to not yet been published to the reseller.
Endpoint URL
https://api.tixstock.com/v1/tickets/get
Authorisation
Authorisation | Description |
---|---|
Bearer Token | A valid bearer token must be provided within the header parameters for the API request. To generate an access token, please see your API settings from within the Tixstock Reseller Admin Area. |
Please see 'Authentication - Bearer Tokens' for further information
Request Data
The supplied data must adhere to the following ruleset and passed as query parameters:
Query Parameters | Description |
---|---|
listing_id | To retrieve data for one listing, the resellers listing ID is required. Type: String |
event_id | The resellers event ID. Type: String |
ticket_type | The reseller can pass through the ticket type to retrieve data for listings for a particular ticket type. Must match the supported ticket types in Tixstock. Paper, eTicket, Members / Season Card |
sort_order | asc / desc Type: String |
order_by | Accepted Values: * listing_id * event_id * event_date * quantity_sold * quantity_available |
per_page | Max: 50 Type: Integer |
page | Type: Integer |
API Response:
Please note the example shown below returns the venue details and performers for the event as empty. These will be correctly populated with the event data.
{
"data": [
{
"id": "9211231",
"broker_id": "123123",
"ticket": {
"general_admission": "false",
"type": "Paper",
"split_type": "No Preferences",
"etickets": [],
"upload_later": "false",
"allow_last_minute_sales": "true"
},
"number_of_tickets_for_sale": {
"quantity_available": 3,
"quantity_sold": 0,
"display_quantity": 3,
"split_quantity": 0
},
"seat_details": {
"category": "Stalls",
"section": "Stalls",
"row": "B",
"first_seat": "11"
},
"face_value": {
"currency": "EUR",
"amount": "22000.00"
},
"display_price": {
"currency": "USD",
"price": "13500.00"
},
"proceed_price": {
"currency": "EUR",
"amount": "32000.00"
},
"restrictions_benefits": {
"options": [
"18's only"
],
"other": "New Other Restriction"
},
"delivery": {
"type": "UPS",
"hand_delivered": "true",
"shipped_date_or_date_in_hand": "2020-03-11"
},
"event": {
"id": "4739302",
"name": "Jimmy Carr Dorking",
"currency": "GBP",
"commission_percentage_fee": "10.00",
"description": "Jimmy Carr Dorking",
"datetime": "2020-06-27T13:46:40+0000",
"status": "Active",
"map_url": "https://upload.wikimedia.org/wikipedia/commons/8/81/AngelStadiumSchematic.svg",
"venue": {
"name": "Dorking Halls",
"address_line_1": "",
"address_line_2": "",
"city": "Dorking",
"state": "SRY",
"postcode": "RH4 1SG",
"country_code": "GB"
},
"use_tixstock_venue_details": "true",
"venue_details": [],
"performers": [
{
"id": "10040",
"name": "Jimmy Carr"
}
]
},
"published_date": "2020-03-10T11:38:54+0000",
"published": "true"
}
],
"meta": {
"mode": "Production",
"type": "ticket.get",
"current_page": 1,
"from": 1,
"last_page": 1,
"path": "https://api.tixstock.com/v1/tickets/get",
"per_page": 10,
"to": 1,
"total": 1,
"request_id": "01e32892ks6brc6f8f6gaq6k6g"
},
"links": {
"self": "link-value",
"first": "https://api.tixstock.com/v1/tickets/get?page=1",
"last": null,
"prev": null,
"next": null
}
}