On-Boarding Categories from Tixstock

When on-boarding categories from Tixstock, you can use our Get Categories Endpoint, this will bring back all the categories currently held in the Tixstock System.

Below is an example showing what the response will look like when performing an GET request against the Get Categories Endpoint.

{
  "data": [
    {
      "name": "Culture, Theatre & Arts",
      "upcoming_events": 0,
      "parent": [],
      "children": []
    },
    {
      "name": "Festivals",
      "upcoming_events": 0,
      "parent": [],
      "children": []
    },
    {
      "name": "Music",
      "upcoming_events": 0,
      "parent": [],
      "children": []
    },
    {
      "name": "Sport",
      "upcoming_events": 895,
      "parent": [],
      "children": [
        {
          "name": "Football",
          "upcoming_events": 907,
          "children": [
            {
              "name": "Serie A",
              "upcoming_events": 270,
              "children": []
            },
            {
              "name": "UEFA Nations League",
              "upcoming_events": 2,
              "children": []
            },
            {
              "name": "Russian Premier League",
              "upcoming_events": 2,
              "children": []
            },
            {
              "name": "Ligue 1",
              "upcoming_events": 208,
              "children": []
            },
            {
              "name": "Scottish Premiership",
              "upcoming_events": 26,
              "children": []
            },
            {
              "name": "Champions League",
              "upcoming_events": 58,
              "children": []
            }
          ]
        }
      ]
    }
  ],
  "meta": {
    "mode": "Production",
    "type": "categories.get",
    "current_page": 1,
    "from": 1,
    "path": "https://api.tixstock.com/v1/categories/get",
    "per_page": 10,
    "to": 1,
    "request_id": "01eg13cw13473tagfvrxscpmbd"
  },
  "links": {
    "self": "link-value",
    "first": "https://api.tixstock.com/v1/categories/get?page=1",
    "last": null,
    "prev": null,
    "next": null
  }
}

When using the Add Events or Update Events Endpoint, you will need to supply a category for all events. The below code example will bring back a paginated list of all categories.

When updating an event, if the event has been mapped to another event in the tixstock system you may not be able to change the category assigned to that event.

/*
*
* 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/categories/get');
$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();

---

Postman Integration

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

---