On-Boarding Performers from Tixstock

When on-boarding performers from Tixstock, you can use the Tixstock Get Performers Endpoint which will assist you in searching through the vast array of performers currently in the Tixstock system.

As you can see from the example response below we include all the events assigned to each performer, along with a "variations" key. The variations key is a list of all known variations of the performer name which are able to be used when adding/editing an event.

{
  "data": [
    {
      "id":"",
      "name":"Liverpool FC",
      "variations":[
        "Liverpool",
        "Liverpool Football Club"
      ],
      "events":[
        {
          "id":"",
          "name":"Liverpool v Watford",
          "currency":"GBP",
          "commission_percentage_fee":"10.00",
          "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"
                }
              ]
            }
          ]
        },
        {
          "id":"",
          "name":"Watford v Liverpool FC",
          "currency":"GBP",
          "commission_percentage_fee":"10.00",
          "datetime":"2020-05-30T15:00:00+0000",
          "status":"Active",
          "use_tixstock_venue_details":"false",
          "venue_details":[
            {
              "id":"",
              "name":"Longside Upper Tier",
              "sections":[
                {
                  "id":"",
                  "name":"Longside Upper Tier"
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "meta": {
    "mode": "Production",
    "type": "performers.get",
    "current_page": 1,
    "from": 1,
    "path": "https://api.tixstock.com/v1/performers/get",
    "per_page": 10,
    "to": 1,
    "request_id": "01eg13cw13473tagfvrxscpmbd"
  },
  "links": {
    "self": "link-value",
    "first": "https://api.tixstock.com/v1/performers/get?page=1",
    "last": null,
    "prev": null,
    "next": null
  }
}

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

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

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

$request->setRequestUrl('https://api.tixstock.com/v1/events/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 performer your system hasn't mapped to, from here you can take a copy of the performer data to use when importing your events into the Tixstock System using either the performers full name or one of it's name variations.

---

Postman Integration

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

---