Bulk Add/Edit Event Endpoint

Resellers are required to add their events to the Tixstock system. This will allow the brokers within Tixstock to list inventory for your event.

The endpoint will attempt to 'event map' your event details to events already populated from within the Tixstock system.

If no event can be mapped, the event details provided will be inserted as a new event into the Tixstock system.

Endpoint URL

https://api.tixstock.com/v1/events/bulk/

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

Parameter Description
events *
An array of events to Add/update within Tixstock
Type: Array
Max: 50 events (Per Request)
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.
Type: Two point decimal number
datetime * Type: Date in ISO-8601 UTC Format
Example: 2020-03-10T17:30:00-0400
venue *
id * The resellers venue ID.
Type: String
name * The events venue name.
Type: String
address_line_1 * The events venue address line 1.
Type: String
address_line_2 The events venue address line 2.
Type: String
city The events venue city.
Type: String
state The events venue state.
Type: String
postcode * The events venue postcode.
Type: String
country_code * ISO-3166-2 Format.
Please refer to supported country codes
Type: String
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.
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
name * The resellers name for the seating category.
Type: String
sections *
An array of all seating sections for the seating catgory
Type: Array
id * The resellers ID for the section.
Type: String
name * The resellers ID for the section.
Type: String
performers *
An array of the event performers
Type: Array
id * The resellers performer ID.
Type: String
name * The performer name.
Type: String
category The name of the category this event should be assigned too.
Category must be a Tixstock Category name a please provide the lowest level category only i.e "Premier League Football" Please note you can not change the category for mapped events
Type: string
Example: Premier League Football

API Response:

{
  "data": [
    {
      "id": "4568",
      "name": "Wolverhampton Wanderers v Sheffield United",
      "success": false,
      "errors": [
        "Venue Detail ID's are required when the venue details are set",
        "The venue section ID's are required if the venue category is set.",
        "The Venue Details provided couldn't be successfully mapped to Tixstock Venue Details."
      ]
    },
    {
      "id": "456800",
      "name": "Manchester United v Manchester City",
      "success": true
    }
  ],
  "meta": {
    "mode": "Production",
    "type": "event.bulk",
    "request_id": "621461af90cadfdaf0e8d4cc25129f91"
  }
}