Get Performers Endpoint

This endpoint will allow resellers to retrieve perfromer information from within the Tixstock system.

The endpoint will also return whether the perfromer is already mapped with the resellers performer from a previous request on the events endpoint.


Endpoint URL

https://api.tixstock.com/v1/performers/get

Authorisation

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 API settings from within the Tixstock Reseller 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 resellers ID for the performer.
Type: String
name The name of the perfromer.
Type: String
mapped_status True/False
Will return performers based on whether the reseller already has mapped with a Tixstock perfromer.
Type: Boolean
sort_order asc / desc
Type: String
order_by Accepted Values:
* id
* name
per_page Max: 50
Type: Integer
page Type: Integer

API Response:

{
  "data": [
    {
      "id":"1",
      "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",
          "map_url": "https://upload.wikimedia.org/wikipedia/commons/8/81/AngelStadiumSchematic.svg",
          "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
  }
}