Get Tickets Endpoint
The Get Tickets endpoint allows Partners to retrieve and filter your feeds inventory.
The results can be narrowed down to a certain by event, ticket type(s) or listing.
Endpoint URL
https://pf.tixstock.com/v1/tickets/feed
| 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 bearer token settings from within the Tixstock Partner 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 listing ID is required. Type: String |
| event_id | The ID assigned to the event. When passed as array, then api will response with only meta values for those particular event_ids in meta object inside "events_meta" key and data will be blank. Type: String/array |
| ticket_types | Filter listings by a particular ticket type assigned to your feed Type: array (Please refer to your available ticket types when using this endpoint) |
| sort_order | asc / desc Type: String |
| category_name | The seat details category the ticket is assigned to. Type: String/array Example: Longside Lower Tier |
| section_name | The seat details section the ticket is assigned to. Type: String/array Example: Longside Lower Tier 1 |
| min_quantity | The available quantity of tickets you would like to filter by. Type: Integer |
| proceed_price_min | The minimum price (in GBP) of tickets you would like to filter by. Type: Float |
| proceed_price_max | The maximum price (in GBP) of tickets you would like to filter by. Type: Float |
| target_currency | The currency in which you would like to see proceed_price amount. Supported currency values are 'GBP', 'USD', 'EUR' Type: String |
| seller_id | The seller_id to filter by. Type: Integer |
| instant_download | To retrieve instant download listings. Permitted values: 1 Type: Boolean |
| restriction_benefit | To filter by restriction/benefit by name. Type: String |
| face_value_percentage | Returns listings with face_value_percentage <= {input_value} face_value_percentage is an indicator of how much more/less the proceed price is with respect to the face value. Type: Float |
| order_by | Accepted Values: listing_id event_id event_date quantity_sold quantity_available price category_name section_name |
| order_by_multiple | To sort by multiple keys. Accepted Values: As per above order_by filter. Example: order_by_multiple[0][key]=category_name&order_by_multiple[0][sort_order]=asc&order_by_multiple[1][key]=price&order_by_multiple[1][sort_order]=asc |
| lighter_response | To retrieve lighter response without event data.Permitted values: 1. Type: Boolean |
| last_updated | The last_updated to filter by. Type: A valid ISO-8601 DateTime format |
| per_page | Max: 50 Type: Integer |
| page | Type: Integer |
API Response:
{
"data": [
{
"id": "434",
"seller_id": 1770303469,
"seller_name": "Mat Philips",
"ticket": {
"general_admission": "false",
"type": "E-Ticket",
"allow_last_minute_sales": "false",
"split_type": "No Preferences",
"etickets": [],
"upload_later": "true",
"instant_download": "false"
},
"event": {
"id": "01g5nw2bgnza5dw5cc0xefccsh",
"name": "Manchester United vs Manchester City",
"datetime": "2023-01-14T14:55:00+0000",
"status": "Active",
"map_url": "https://upload.wikimedia.org/wikipedia/commons/8/81/AngelStadiumSchematic.svg",
"venue": {
"id": "01fwnncmg6796w6rs5scx4wesx",
"name": "Old Trafford",
"address_line_1": "Sir Matt Busby Way",
"address_line_2": "",
"city": "Manchester",
"state": "LAN",
"postcode": "M160RA,",
"country_code": "GB",
"latitude": 53.4630589,
"longitude": -2.2913401
},
"performers": [
{
"id": "01fwnnf3jkjwkzttd0hh3kcs01",
"name": "Manchester United FC"
},
{
"id": "01fwnnf3jj1a1mkmxs27872aj4",
"name": "Manchester City FC"
}
]
},
"number_of_tickets_for_sale": {
"quantity_available": 98,
"quantity_sold": 1,
"display_quantity": 0,
"split_quantity": 0,
"quantity_on_hold": 2
},
"seat_details": {
"category": "Longside Lower Tier",
"section": "",
"row": "1",
"first_seat": "1000"
},
"face_value": {
"currency": "GBP",
"amount": "10.00"
},
"proceed_price": {
"currency": "GBP",
"amount": "33.00"
},
"restrictions_benefits": {
"options": [],
"other": ""
},
"delivery": {
"type": "SHIPPING",
"hand_delivered": "false",
"shipped_date_or_date_in_hand": "2022-09-16",
"options": [
{
"name": "Local",
"value": "10"
},
{
"name": "International",
"value": "11"
}
]
},
"face_value_percentage": "330.00"
}
],
"meta": {
"mode": "Production",
"type": "partner.ticket.get",
"current_page": 1,
"from": 1,
"last_page": 1,
"path": "https://pf.tixstock.com/v1/tickets/feed",
"per_page": 10,
"to": 1,
"total": 1,
"min_price": "33.00",
"max_price": "1000.00",
"categories": {
"Floor": "true",
"Lower Tier": "true",
"Upper Tier": "true"
},
"sections": {
"Lower Tier 3": "56.00",
"Upper Tier 1": "6500.00",
"Lower Tier 10": "200.00",
"Floor B": "4.00",
"Floor C": "9000.00",
"Floor A": "360.00"
},
"total_tickets": 98,
"last_updated": "2023-10-09 15:32:50",
"category_section_stats": {
"categories": [
{
"name": "Longside Lower Tier",
"listings_count": 3,
"min_price": 1.16,
"avg_price": 108.44
},
{
"name": "Longside Upper Tier",
"listings_count": 2,
"min_price": 1292.46,
"avg_price": 5220.38
},
{
"name": "Shortside Lower Tier",
"listings_count": 2,
"min_price": 232.67,
"avg_price": 988.83
}
],
"sections": [
{
"name": "Longside Lower Tier 14",
"listings_count": 1,
"min_price": 1.16,
"avg_price": 1.16
},
{
"name": "Longside Upper Tier 92",
"listings_count": 1,
"min_price": 1292.46,
"avg_price": 1292.46
},
{
"name": "Longside Lower Tier 17",
"listings_count": 1,
"min_price": 232.67,
"avg_price": 232.67
},
{
"name": "Shortside Lower Tier 10",
"listings_count": 1,
"min_price": 1744.99,
"avg_price": 1744.99
},
{
"name": "Shortside Lower Tier 9",
"listings_count": 1,
"min_price": 232.67,
"avg_price": 232.67
},
{
"name": "Longside Lower Tier 13",
"listings_count": 1,
"min_price": 91.48,
"avg_price": 91.48
},
{
"name": "Longside Upper Tier 94",
"listings_count": 1,
"min_price": 9148.3,
"avg_price": 9148.3
}
]
},
"request_id": "01e32892ks6brc6f8f6gaq6k6g"
},
"links": {
"self": "link-value",
"first": "https://pf.tixstock.com/v1/tickets/feed?page=1",
"last": null,
"prev": null,
"next": null
}
}
API Response when ticket type Paper:
{
"data": [
{
"id": "01ha4qn0yg5q1zwrbvk5z3a54w",
"seller_id": 1770303465,
"seller_name": "Robert",
"ticket": {
"general_admission": "false",
"type": "Paper",
"allow_last_minute_sales": "false",
"split_type": "No Preferences",
"etickets": [],
"upload_later": "true",
"instant_download": "false"
},
"event": {
"id": "01h43k5qjxprc0bhqdddq4q1r9",
"name": "Arsenal FC vs Chelsea FC",
"datetime": "2024-03-16T15:00:00+0000",
"status": "Active",
"map_url": "https://upload.wikimedia.org/wikipedia/commons/8/81/AngelStadiumSchematic.svg",
"venue": {
"id": "01fwjww9a9evtbfb6vq8rbqwkv",
"name": "Emirates Stadium",
"address_line_1": "Highbury House",
"address_line_2": "",
"city": "London",
"state": "",
"postcode": "N77AJ",
"country_code": "GB",
"latitude": 51.5570434,
"longitude": -0.1062994
},
"performers": [
{
"id": "01fwjwzxxa945cx6qx2sbbm42f",
"name": "Arsenal FC"
},
{
"id": "01fwjwzxxfjm70t7ngp0y7n72k",
"name": "Chelsea FC"
}
],
"category": {
"id": "01fwjxakp06qyq7vjnap5s1a10",
"name": "English Premier League",
"upcoming_events": 0,
"parent": []
}
},
"number_of_tickets_for_sale": {
"quantity_available": 8,
"quantity_sold": 0,
"display_quantity": 0,
"split_quantity": 0,
"quantity_on_hold": 0
},
"seat_details": {
"category": "Away Fan Section",
"section": "Away Fan Section",
"row": "PK",
"first_seat": "55"
},
"face_value": {
"currency": "GBP",
"amount": "50.00"
},
"proceed_price": {
"currency": "GBP",
"amount": "510.00"
},
"restrictions_benefits": {
"options": [],
"other": ""
},
"delivery": {
"type": "SHIPPING",
"hand_delivered": "false",
"shipped_date_or_date_in_hand": "2024-03-09",
"options": [
{
"name": "Local",
"value": "10"
},
{
"name": "International",
"value": "11"
}
]
},
"face_value_percentage": "1020.00"
}
],
"meta": {
"mode": "Sandbox",
"type": "partner.ticket.get",
"current_page": 1,
"from": 1,
"last_page": 1,
"links": [
{
"url": null,
"label": "Previous",
"active": false
},
{
"url": "https://pf.tixstock.com/v1/tickets/feed?page=1",
"label": "1",
"active": true
},
{
"url": null,
"label": "Next",
"active": false
}
],
"path": "https://pf.tixstock.com/v1/tickets/feed",
"per_page": 10,
"to": 1,
"total": 1,
"min_price": "510.00",
"max_price": "510.00",
"categories": {
"Away Fan Section": "true",
"Longside Lower Tier": "true",
"Longside Upper Tier": "true",
"Shortside Lower Tier": "true",
"Shortside Upper Tier": "false",
"VIP Club Level": "false",
"VIP Executive Box": "false"
},
"sections": {
"Away Fan Section": "102.00",
"Longside Lower Tier 13": "4590.00",
"Longside Lower Tier": "3399.66",
"Shortside Upper Tier 104": "20.40",
"Longside Lower Tier 15": "20.40",
"VIP Club Level": "102.00",
"Longside Upper Tier 109": "1020000.00",
"Shortside Lower Tier 6": "1133.22",
"Longside Upper Tier 93": "3524.10",
"Longside Lower Tier 1": "33999999.66",
"Shortside Lower Tier 10": "1530.00"
},
"total_tickets": 99,
"last_updated": "2023-10-09 15:32:50",
"category_section_stats": {
"categories": [
{
"name": "Away Fan Section",
"listings_count": 8,
"min_price": "99.00",
"avg_price": "57644.63"
},
{
"name": "Longside Lower Tier",
"listings_count": 5,
"min_price": "3333.00",
"avg_price": "2006669133.00"
},
{
"name": "Longside Upper Tier",
"listings_count": 1,
"min_price": "3455.00",
"avg_price": "3455.00"
},
{
"name": "Shortside Lower Tier",
"listings_count": 3,
"min_price": "1111.00",
"avg_price": "1611.00"
},
{
"name": "Shortside Upper Tier",
"listings_count": 0,
"min_price": 0,
"avg_price": 0
},
{
"name": "VIP Club Level",
"listings_count": 0,
"min_price": 0,
"avg_price": 0
},
{
"name": "VIP Executive Box",
"listings_count": 0,
"min_price": 0,
"avg_price": 0
}
],
"sections": [
{
"name": "Away Fan Section",
"listings_count": 7,
"min_price": "100.00",
"avg_price": "65865.43"
},
{
"name": "Longside Lower Tier",
"listings_count": 2,
"min_price": "3333.00",
"avg_price": "3916.50"
},
{
"name": "Longside Lower Tier 1",
"listings_count": 2,
"min_price": "33333333.00",
"avg_price": "5016666666.00"
},
{
"name": "Longside Lower Tier 13",
"listings_count": 1,
"min_price": "4500.00",
"avg_price": "4500.00"
},
{
"name": "Longside Upper Tier 93",
"listings_count": 1,
"min_price": "3455.00",
"avg_price": "3455.00"
},
{
"name": "Shortside Lower Tier 10",
"listings_count": 1,
"min_price": "1500.00",
"avg_price": "1500.00"
},
{
"name": "Shortside Lower Tier 6",
"listings_count": 2,
"min_price": "1111.00",
"avg_price": "1666.50"
}
]
},
"bearer_token_id": "01gnvy1qfaczc4fdw87xr9wnpx",
"reseller_id": "01gngs60qy2m0ar4dtp13p8q9c",
"ip": "127.0.0.1",
"request_id": ""
},
"links": {
"self": "link-value",
"first": "https://pf.tixstock.com/v1/tickets/feed?page=1",
"last": null,
"prev": null,
"next": null
}
}
API Response when filter by event_id as array:
{
"data": [],
"meta": {
"mode": "Sandbox",
"type": "partner.ticket.get",
"events_meta": [
{
"event_id": "01fwjwzp1cv0dc46x91032abfe",
"map_url": "https://upload.wikimedia.org/wikipedia/commons/8/81/AngelStadiumSchematic.svg",
"min_price": "525.00",
"max_price": "15750.00",
"categories": {
"Floor": "true",
"Lower Tier": "true",
"Upper Tier": "true"
},
"sections": {
"Lower Tier 3": "56.00",
"Upper Tier 1": "6500.00",
"Lower Tier 10": "200.00",
"Floor B": "4.00",
"Floor C": "9000.00",
"Floor A": "360.00"
},
"total_tickets": 2
}
],
"bearer_token_id": "01gpxcn2vzzx79b5etkz09m5w0",
"reseller_id": "01gngs60qy2m0ar4dtp13p8q9c",
"ip": "127.0.0.1",
"request_id": "01gr6nhcfmsvk3rr4za24zeke0"
}
}