On-Boarding Venues from Tixstock

When on-boarding venues from Tixstock, you can use our Get Venues Endpoint, this will bring back all of the venues currently held in the Tixstock System and their assigned events.

In addition to the events assigned to the venues you will also find a variations key, this returns a list of all know name variations for the specific venue. Below is an example response showing what the response will look like when performing an GET request against the Get Venues endpoint.

{
  "data": [
    {
      "id": "",
      "name": "Anfield",
      "address_line_1": "Anfield Rd,",
      "address_line_2": "Anfield",
      "city": "Liverpool",
      "state": "",
      "postcode": "L4 0TH",
      "country_code": "GB",
      "variations": [
         "Anfield",
        "Anfield Stadium"
      ],
      "events": [
        {
          "id": "",
          "name": "Liverpool v Watford",
          "currency": "GBP",
          "commission_percentage_fee": null,
          "datetime": "2020-05-17T15:00:00+0000",
          "status": "Active",
          "use_tixstock_venue_details": "false",
          "venue_details": [
            {
              "id": "",
              "name": "Longside Upper Tier",
              "sections": [
                {
                  "id": "",
                  "name": "Longside Upper Tier"
                }
              ]
            }
          ],
          "performers": [
            {
              "id": "",
              "name": "Liverpool FC"
            },
            {
              "id": "",
              "name": "Watford FC"
            }
          ]
        }
      ],
    }
  ],
  "meta": {
    "mode": "Production",
    "type": "venues.get",
    "current_page": 1,
    "from": 1,
    "path": "https://api.tixstock.com/v1/venues/get",
    "per_page": 10,
    "to": 1,
    "request_id": "01eg13cw13473tagfvrxscpmbd"
  },
  "links": {
    "self": "link-value",
    "first": "https://api.tixstock.com/v1/venues/get?page=1",
    "last": null,
    "prev": null,
    "next": null
  }
}

When using the Get Venues endpoint you can pass through a mapped_status parameter with a true/false value to bring back all the venues that are/are not already mapped with your system, this will make it easier to import all venues that you currently do not use. The below code example will bring back a paginated list of all venues not currently mapped with your system.

/*
*
* PHP code example for getting venues from the Tixstock System.
*
*/

$client = new http\Client;
$request = new http\Client\Request;

$request->setRequestUrl('https://api.tixstock.com/v1/venues/get?mapped_status=false');
$request->setRequestMethod('GET');
$request->setHeaders(
    array(
      'Content-Type' => 'application/json',
      'Authorization' => 'Bearer [Your Bearer Token]'
    )
);

$client->enqueue($request)->send();
$response = $client->getResponse();

echo $response->getBody();

Using the above will bring back a list of all venues your system hasn't mapped to from Tixstock, from here you can take a copy of the Venue data to use when importing your events into the Tixstock System using either the full venue name or one of it's name variations.

---

Postman Integration

All of our endpoints are available as postman collection. You can gain access to the collections using the button below.

---