Checking If Your Event Already Exists in Tixstocks System

When onboarding your events into Tixstock, please search Tixstocks events first to check if the event already exist. This can be accomplished by using Tixstocks Get Events endpoint. The following arguments can be used to narrow down the search results, Event name, Venue name, Performer Name, followed by a Start Date & End Date date range.

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

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

$request->setRequestUrl('https://api.tixstock.com/v1/events/get?
    venue_name=Carrow Road
    &performer_name=Norwich+City
    &start_date=2020-05-09T14:00:00+0000
');
$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();

If the event is in Tixstock, the API will return a response like the below, and then you can proceed to Tixstock Already Has Our Event In Its System any events in Tixstock that return an empty string as the ID are ones not currently mapped with your system.

{
  "data": [
    {
      "id": "94159864",
      "name": "Norwich City FC vs Burnley FC Tickets",
      "currency": "EUR",
      "commission_percentage_fee": "10.00",
      "datetime": "2020-05-09T14:00:00+0000",
      "status": "Active",
      "map_url": "https://upload.wikimedia.org/wikipedia/commons/8/81/AngelStadiumSchematic.svg",
      "venue": {
        "id": "7845665",
        "name": "Carrow Road",
        "address_line_one": "",
        "address_line_two": "",
        "city": "Norwich",
        "state": "NFK",
        "postcode": "NR1 1JE",
        "country_code": "GB"
      },
      "use_tixstock_venue_details": "false",
      "venue_details": [
        {
          "id": "1234121",
          "name": "Away Fan Section",
          "sections": [
            {
              "id": "241231",
              "name": "Away Fan Section 21"
            },
            {
              "id": "241121",
              "name": "Away Fan Section 22"
            },
            {
              "id": "241011",
              "name": "Away Fan Section 23"
            }
          ]
        }
      ],
      "performers": [
        {
          "id": "5642621",
          "name": "Norwich City FC"
        },
        {
          "id": "5642912",
          "name": "Burnley FC"
        }
      ],
      "category": {
        "name": "Football",
        "upcoming_events": 908,
        "parent": {
          "name": "Sport",
          "parent": []
        }
      }
    }
  ],
  "meta": {
    "mode": "Production",
    "type": "event.get",
    "current_page": 1,
    "from": 1,
    "path": "https://api.tixstock.com/v1/events/get",
    "per_page": 10,
    "to": 1,
    "request_id": "01eg13cw13473tagfvrxscpmbd"
  },
  "links": {
    "self": "link-value",
    "first": "https://api.tixstock.com/v1/events/get?page=1",
    "last": null,
    "prev": null,
    "next": null
  }
}

In the instance Tixstock does not hold the event that you are searching for, the following empty response will be returned and you will need to proceed to Tixstock Doesn't Hold Our Event for further assistance with adding your event to Tixstock.

{
    "data": [],
    "meta": {
        "mode": "Production",
        "type": "event.get",
        "current_page": 1,
        "from": 1,
        "path": "https://api.tixstock.com/v1/events/get",
        "per_page": 1,
        "to": 1,
        "request_id": "01eg13cw13473tagfvrxscpmbd"
    },
    "links": {
        "self": "link-value",
        "first": "https://api.tixstock.com/v1/events/get?page=1",
        "last": null,
        "prev": null,
        "next": null
    }
}

---