Update Event Endpoint

The update event endpoint will allow resellers to update their event information.

Endpoint URL

https://api.tixstock.com/v1/events/update/{event_id}

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

Notes:

If the event has listings assigned you will be restricted to updating the event status (to cancelled) or changing the commission percentage fee all other changes will be discarded.

The supplied data must adhere to the following ruleset:

Parameter

Description

name *

The name of the event.
Type: String

currency *

The currency that the event listings will be sold in. Please refer to supported currencies.
Format: ISO 4217
Type: String

commission_percentage_fee

The commission percentage fee charged to a broker for listing tickets for this event.
Please note: If the commission percentage fee is not supplied Tixstock sets a default fee when calculating the display price for a broker.
Type: Two point decimal number

datetime *

Type: Date in ISO-8601 UTC Format
Example: 2020-03-10T17:30:00-0400
Please note: If the event has listings assigned this field is no longer updatable

status *

Type: String
Accepted Values: Active / Cancelled
Please note: Once the event has been cancelled, you will not be able to update the event details.

venue *

id *	The resellers venue ID. Type: String Please note: If the event has listings assigned this field is no longer updatable
name *	The events venue name. Type: String Please note: If the event has listings assigned this field is no longer updatable
address_line_1 *	The events venue address line 1. Type: String Please note: If the event has listings assigned this field is no longer updatable
address_line_2	The events venue address line 2. Type: String Please note: If the event has listings assigned this field is no longer updatable
city	The events venue city. Type: String Please note: If the event has listings assigned this field is no longer updatable
state	The events venue state. Type: String Please note: If the event has listings assigned this field is no longer updatable
postcode	The events venue postcode. Type: String Please note: If the event has listings assigned this field is no longer updatable
country_code *	ISO-3166-2 Format. Please refer to supported country codes Type: String Please note: If the event has listings assigned this field is no longer updatable

use_tixstock_venue_details *

Allows the reseller to use Tixstock Venue Details rather than their own.
If the reseller choices to use Tixstock venue details the venue_detail field must be empty or not provided.
Type: Int

0 = No
1 = Yes

Please note: Tixstock will display an error when the reseller uses Tixstock Venue Details and resellers event cannot be mapped to a Tixstock event.
Please note: If the event has listings assigned this field is no longer updatable

venue_details

It is required that the reseller provide the venue’s categories and sections required for the seating information for the event, when not using Tixstock venue details.
If no venue details are provided and use_tixstock_venue_details is set to 0, the event will be added as 'General Admission.'
Type: Array

id *

The resellers ID for the seating category.
Type: Int
Please note: If the event has listings assigned this field is no longer updatable

name *

The resellers name for the seating category.
Type: String
Please note: If the event has listings assigned this field is no longer updatable

sections *

An array of all seating sections for the seating catgory Type: Array
id *	The resellers ID for the section. Type: String Please note: If the event has listings assigned this field is no longer updatable
name *	The resellers ID for the section. Type: String Please note: If the event has listings assigned this field is no longer updatable

performers *

An array of the event performers Type: Array
id *	The resellers performer ID. Type: String Please note: If the event has listings assigned this field is no longer updatable
name *	The performer name. Type: String Please note: If the event has listings assigned this field is no longer updatable

API Response:

Please note that depending on whether the event has been mapped to an existing Tixstock event, the data returned will either be Tixstock’s event data or the resellers event data.

{
  "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.update",
    "request_id": "67c6a1e7ce56d3d6fa748ab6d9af3fd7"
  },
  "message": "Event successfully updated."
}