Get Venues Endpoint
This endpoint will allow partners to retrieve venue information from within the Tixstock system all venues will return a full list of all events playing at that particular venue, along with the venue details for that event.
This endpoint can be useful for performing searches of events in the system in radial area by filtering the results down by a location and a radius in miles from the centre point.
Endpoint URL
https://sandbox-pf.tixstock.com/v1/venues/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 |
|---|---|
| id | The ID for the venue. Type: String |
| name | The name of the venue. Type: String |
| event_id | The id of an event to filter by. Type: String |
| address_line_one | The first line of the address for the venue. Type: String |
| city | The City of the venue is located. Type: String |
| postcode | The Postcode for the venue Type: String |
| country_code | ISO-3166-2 Format. Please refer to supported country codes Type: String |
| location | Full/partial address than can be used as a center point, this is used to run a radial search for venues in an area. Type: String |
| coordinates | Coordinates to be used as a center point for a radial search. Type: String |
| radius | A distance in miles to perform a radial search form the location/coordinates center point Type: Integer |
| sort_order | asc / desc Type: String |
| order_by | Accepted Values: * id * name |
| per_page | Max: 50 Type: Integer |
| page | Type: Integer |
| has_listing | If set to true, will return only the venues that have listings on it Type: Boolean |
API Response:
{
"data": [
{
"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,
"events": [
{
"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_details": [
{
"name": "Away Fan Section",
"sections": [
"Away Fan Section"
]
},
{
"name": "Longside Lower Tier",
"sections": [
"Longside Lower Tier",
"Longside Lower Tier E230",
"Longside Lower Tier E231",
"Longside Lower Tier N1403",
"Longside Lower Tier N1404",
"Longside Lower Tier N1405",
"Longside Lower Tier N1406",
"Longside Lower Tier N1407",
"Longside Lower Tier N1408",
"Longside Lower Tier N1409",
"Longside Lower Tier N1410",
"Longside Lower Tier N1411",
"Longside Lower Tier N2402",
"Longside Lower Tier N2403",
"Longside Lower Tier N2404",
"Longside Lower Tier N2405",
"Longside Lower Tier N2406",
"Longside Lower Tier N2407",
"Longside Lower Tier N2408",
"Longside Lower Tier N2409",
"Longside Lower Tier N2410",
"Longside Lower Tier N2411",
"Longside Lower Tier N2412",
"Longside Lower Tier S121",
"Longside Lower Tier S122",
"Longside Lower Tier S123",
"Longside Lower Tier S124",
"Longside Lower Tier S125",
"Longside Lower Tier S126",
"Longside Lower Tier S127",
"Longside Lower Tier S128",
"Longside Lower Tier W211",
"Longside Lower Tier W212"
]
},
{
"name": "Longside Upper Tier",
"sections": [
"Longside Upper Tier",
"Longside Upper Tier N3401",
"Longside Upper Tier N3402",
"Longside Upper Tier N3403",
"Longside Upper Tier N3404",
"Longside Upper Tier N3405",
"Longside Upper Tier N3406",
"Longside Upper Tier N3407",
"Longside Upper Tier N3408",
"Longside Upper Tier N4401",
"Longside Upper Tier N4402",
"Longside Upper Tier N4403",
"Longside Upper Tier N4404",
"Longside Upper Tier N4405",
"Longside Upper Tier N4406",
"Longside Upper Tier N4407",
"Longside Upper Tier N4408",
"Longside Upper Tier NE3421",
"Longside Upper Tier NE3422",
"Longside Upper Tier NE3423",
"Longside Upper Tier NE3424",
"Longside Upper Tier NW3427",
"Longside Upper Tier NW3428",
"Longside Upper Tier NW3429",
"Longside Upper Tier NW3430",
"Longside Upper Tier S226",
"Longside Upper Tier S227",
"Longside Upper Tier S228",
"Longside Upper Tier S229"
]
},
{
"name": "Shortside Lower Tier",
"sections": [
"Shortside Lower Tier",
"Shortside Lower Tier E132",
"Shortside Lower Tier E133",
"Shortside Lower Tier E134",
"Shortside Lower Tier E135",
"Shortside Lower Tier E136",
"Shortside Lower Tier E137",
"Shortside Lower Tier E138",
"Shortside Lower Tier E232",
"Shortside Lower Tier E233",
"Shortside Lower Tier E234",
"Shortside Lower Tier E235",
"Shortside Lower Tier E236",
"Shortside Lower Tier E237",
"Shortside Lower Tier E238",
"Shortside Lower Tier E239",
"Shortside Lower Tier N1401",
"Shortside Lower Tier N1413",
"Shortside Lower Tier N2401",
"Shortside Lower Tier N2413",
"Shortside Lower Tier W101",
"Shortside Lower Tier W102",
"Shortside Lower Tier W103",
"Shortside Lower Tier W104",
"Shortside Lower Tier W105",
"Shortside Lower Tier W106",
"Shortside Lower Tier W201",
"Shortside Lower Tier W202",
"Shortside Lower Tier W203",
"Shortside Lower Tier W204",
"Shortside Lower Tier W206",
"Shortside Lower Tier W207",
"Shortside Lower Tier W208",
"Shortside Lower Tier W209",
"Shortside Lower Tier W210",
"Shortside Lower Tier WL0"
]
},
{
"name": "Shortside Upper Tier",
"sections": [
"Shortside Upper Tier",
"Shortside Upper Tier E331",
"Shortside Upper Tier E332",
"Shortside Upper Tier E333",
"Shortside Upper Tier E334",
"Shortside Upper Tier E335",
"Shortside Upper Tier E336",
"Shortside Upper Tier NE3417",
"Shortside Upper Tier NE3418",
"Shortside Upper Tier NE3419",
"Shortside Upper Tier NE3420",
"Shortside Upper Tier NW3431",
"Shortside Upper Tier NW3432",
"Shortside Upper Tier NW3433",
"Shortside Upper Tier NW3434",
"Shortside Upper Tier W3101",
"Shortside Upper Tier W3102",
"Shortside Upper Tier W3103",
"Shortside Upper Tier W3104",
"Shortside Upper Tier W3105",
"Shortside Upper Tier W3106"
]
},
{
"name": "VIP Packages",
"sections": [
"VIP Packages",
"VIP Packages Hospitality Lounge",
"VIP Packages N2406",
"VIP Packages N2407",
"VIP Packages N2408",
"VIP Packages N3413",
"VIP Packages N3414",
"VIP Packages N3415",
"VIP Packages N3416",
"VIP Packages NE3418",
"VIP Packages NE3423",
"VIP Packages NE3425",
"VIP Packages NE3426",
"VIP Packages NW3428",
"VIP Packages NW3433",
"VIP Packages NW3435",
"VIP Packages NW3436",
"VIP Packages S221",
"VIP Packages S222",
"VIP Packages S223",
"VIP Packages S224",
"VIP Packages W205"
]
},
{
"name": "500 and Kit",
"sections": [
"500 Club 3426",
"500 Club NE3425",
"Kit Room NW3435",
"Kit Room NW3436"
]
},
{
"name": "Academy",
"sections": [
"Academy NE3425",
"Academy NE3426"
]
},
{
"name": "Champions",
"sections": [
"Champions Club N3413",
"Champions Club N3414",
"Champions Club N3416"
]
},
{
"name": "Evolution",
"sections": [
"Evolution NE3418",
"Evolution NE3423"
]
},
{
"name": "International",
"sections": [
"International W205"
]
},
{
"name": "Lancashire Package",
"sections": [
"Lancashire NW3418",
"Lancashire NW3428",
"Lancashire NW3433",
"Lancashire Package N1403",
"Lancashire Package N1404",
"Lancashire Package N1405",
"Lancashire Package N1406",
"Lancashire Package N1407",
"Lancashire Package N1408",
"Lancashire Package N1409",
"Lancashire Package N1410",
"Lancashire Package N1411",
"Lancashire Package N2403",
"Lancashire Package N2404",
"Lancashire Package N2405",
"Lancashire Package N2409",
"Lancashire Package N2410",
"Lancashire Package N2411",
"Lancashire Package N3403",
"Lancashire Package N3404",
"Lancashire Package N3405",
"Lancashire Package N3406"
]
},
{
"name": "Middle South Stand",
"sections": [
"Middle South Stand 221"
]
},
{
"name": "Museum Package",
"sections": [
"Museum Package N1403",
"Museum Package N1404",
"Museum Package N1405",
"Museum Package N1406",
"Museum Package N1407",
"Museum Package N1408",
"Museum Package N1409",
"Museum Package N1410",
"Museum Package N1411",
"Museum Package N2403",
"Museum Package N2404",
"Museum Package N2405",
"Museum Package N2409",
"Museum Package N2410",
"Museum Package N2411"
]
},
{
"name": "Museum Postmatch",
"sections": [
"Museum Postmatch N3407",
"Museum Postmatch N3408"
]
},
{
"name": "Museum Prematch",
"sections": [
"Museum Prematch N3407",
"Museum Prematch N3408"
]
},
{
"name": "Red Cafe",
"sections": [
"Red Cafe N3407",
"Red Cafe N3408"
]
}
],
"performers": [
{
"id": "01fwnnf3jkjwkzttd0hh3kcs01",
"name": "Manchester United FC"
},
{
"id": "01fwnnf3jj1a1mkmxs27872aj4",
"name": "Manchester City FC"
}
]
}
]
}
],
"meta": {
"mode": "Sandbox",
"type": "partner.venue.get",
"current_page": 1,
"from": 1,
"last_page": 1,
"path": "https://sandbox-pf.tixstock.com/v1/venues/feed",
"per_page": 10,
"to": 1,
"total": 1,
"request_id": "01e32892ks6brc6f8f6gaq6k6g"
},
"links": {
"self": "link-value",
"first": "https://sandbox-pf.tixstock.com/v1/venues/feed?page=1",
"last": null,
"prev": null,
"next": null
}
}