Get Tickets Endpoint

The get ticket endpoint will allow resellers to retrieve listing information for their exchange.

The results can be filtered and paginated. The response will return all Tixstock listings assigned to the reseller regardless whether it's published status. Please be aware that results can include listings without an ID assigned due to not yet been published to the reseller.


Endpoint URL

https://api.tixstock.com/v1/tickets/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
listing_id To retrieve data for one listing, the resellers listing ID is required.
Type: String
event_id The resellers event ID.
Type: String
ticket_type The reseller can pass through the ticket type to retrieve data for listings for a particular ticket type.
Must match the supported ticket types in Tixstock.
Paper, eTicket, Members / Season Card
sort_order asc / desc
Type: String
order_by Accepted Values:
* listing_id
* event_id
* event_date
* quantity_sold
* quantity_available
per_page Max: 50
Type: Integer
page Type: Integer

API Response:

Please note the example shown below returns the venue details and performers for the event as empty. These will be correctly populated with the event data.

{
    "data": [
        {
            "id": "9211231",
            "broker_id": "123123",
            "ticket": {
                "general_admission": "false",
                "type": "Paper",
                "split_type": "No Preferences",
                "etickets": [],
                "upload_later": "false",
                "allow_last_minute_sales": "true"
            },
            "number_of_tickets_for_sale": {
                "quantity_available": 3,
                "quantity_sold": 0,
                "display_quantity": 3,
                "split_quantity": 0                
            },
            "seat_details": {
                "category": "Stalls",
                "section": "Stalls",
                "row": "B",
                "first_seat": "11"
            },
            "face_value": {
                "currency": "EUR",
                "amount": "22000.00"
            },
            "display_price": {
                "currency": "USD",
                "price": "13500.00"
            },
            "proceed_price": {
                "currency": "EUR",
                "amount": "32000.00"
            },
            "restrictions_benefits": {
                "options": [
                    "18's only"
                ],
                "other": "New Other Restriction"
            },
            "delivery": {
                "type": "UPS",
                "hand_delivered": "true",
                "shipped_date_or_date_in_hand": "2020-03-11"
            },
            "event": {
               "id": "4739302",
               "name": "Jimmy Carr Dorking",
               "currency": "GBP",
               "commission_percentage_fee": "10.00",
               "description": "Jimmy Carr Dorking",
               "datetime": "2020-06-27T13:46:40+0000",
               "status": "Active",
               "map_url": "https://upload.wikimedia.org/wikipedia/commons/8/81/AngelStadiumSchematic.svg",
               "venue": {
                   "name": "Dorking Halls",
                   "address_line_1": "",
                   "address_line_2": "",
                   "city": "Dorking",
                   "state": "SRY",
                   "postcode": "RH4 1SG",
                   "country_code": "GB"
               },
               "use_tixstock_venue_details": "true", 
               "venue_details": [],
               "performers": [
                   {
                       "id": "10040",
                       "name": "Jimmy Carr"
                   }
               ]
            },
            "published_date": "2020-03-10T11:38:54+0000",
            "published": "true"
        }
    ],
    "meta": {
        "mode": "Production",
        "type": "ticket.get",
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "path": "https://api.tixstock.com/v1/tickets/get",
        "per_page": 10,
        "to": 1,
        "total": 1,
        "request_id": "01e32892ks6brc6f8f6gaq6k6g"
    },
    "links": {
        "self": "link-value",
        "first": "https://api.tixstock.com/v1/tickets/get?page=1",
        "last": null,
        "prev": null,
        "next": null
    }
}