Publish API

Use the Publish API to publish events, venues and attractions. The API provides the opportunity to make your events, venues and attractions available within the Discovery API.

Overview

Authentication

To run a successful API call, you will need to pass your API Key as the query parameter apikey.

Example: https://app.ticketmaster.com/publish/v2/events?apikey={apikey}

Root URL

https://app.ticketmaster.com/publish/{API version}

Publish Events

Method: POST. Authentication required. Publish events accessible within the Discovery API.

publish/{version}/events

URL parameters:

Parameter Description Type Default Value Required
version The API Version. string “v2” Yes
{
    "source" : {
        "id" : "test_id_0009",
        "name" : "test-source"
    },
    "test": true,
    "names": {
        "en-us": "example test event tnt1"
    },
    "publicVisibility": {
        "startDateTime": "2015-10-29T15:00:00Z",
        "visible": true
    },
    "dates": {
        "start": {
            "dateTime": "2016-04-15T01:00:00Z",
            "localDate": "2016-04-14",
            "localTime": "19:00:00"
        },
        "timezone": "America/Edmonton"
    },
    "venue": {
        "source" : {
            "id" : "test_venue_id_0001",
            "name" : "test-source"
        }
    }
}

Request structure:

  • active (boolean) - true if the entity is active; inactive entity won’t appear in Discovery API.
  • additionalInfos (object) - map of locale to value for any additional informations on the event.
  • attractions (array) - list of attractions in the event.
    • id (string) - the id of the attraction as returned by the Discovery API. If specified, then the source element should not be set. Either id or source must be specified.
    • source (object) - the id and source name of the attraction. Must be specified if id is not. Either id or source must be specified.
      • id (string) - the publisher’s id of the attraction.
      • name (string) - the publisher’s name.
  • classifications (array) - list of classifications for the event.
    • primary (boolean) - true if this is the event’s primary classification
    • segment (object) - segment.
      • id (string) - the ID of the segment. (not required if names is provided)
      • names (object) - map of locale to value for the names of the segment. (not required if id is provided)
    • genre (object) - genre
      • id (string) - the ID of the genre. (not required if names is provided)
      • names (object) - map of locale to value for the names of the genre. (not required if id is provided)
    • subGenre (object) - subGenre
      • id (string) - the ID of the subGenre. (not required if names is provided)
      • names (object) - map of locale to value for the names of the subGenre. (not required if id is provided)
  • dates (object) - all the dates related to the event.
    • start (object) - the start date of the event.
      • localDate (string) - the start date in the event timezone.
      • localTime (string) - the start time in the event timezone.
      • dateTime (string) - the start date and time of the event in UTC.
      • dateTBD (boolean) - true if the date is to be determined, false otherwise.
      • dateTBA (boolean) - true if the date is to be announced, false otherwise.
      • timeTBA (boolean) - true if the time is to be announced, false otherwise.
      • noSpecificTime (boolean) - true if the event starts at no specific time, false otherwise.
    • access (object) - the access date of the event.
      • startDateTime (string) - the start date and time of access to the event int UTC.
      • startApproximate (boolean) - true if the start date and time is approximate, false otherwise.
      • endDateTime (string) - the end date and time of access to the event int UTC.
      • endApproximate (boolean) - true if the end date and time is approximate, false otherwise.
    • end (object) - the end date of the event.
      • localTime (string) - the end time in the event timezone.
      • dateTime (string) - the end date and time of the event in UTC.
      • approximate (boolean) - true if the end date and time are approximate, false otherwise.
    • timezone (string) - the timezone of the event.
  • descriptions (object) - map of locale to value for the description of the event.
  • infos (object) - map of locale to value for any informations on the event.
  • images (array) - list of images of the event.
    • height (number) - the height of the image.
    • ratio (string) - the ratio of the image ex.: 3x2, 16x9, …
    • url (string) - the URL of the image.
    • width (number) - the width of the image.
  • names (object) - map of locale to value for the names of the event.
  • outlets (array) - list of outlets for the event.
    • url (string) - the URL of the outlet.
    • type (string) - the type of outlet (allowedValues:[“venueBoxOffice”]).
  • place (object) - the place where the event occurs.
    • names (object) - map of locale to value for the names of the place.
    • address (object) - the address of the place of the event.
      • line1s (object) - map of locale to value for the first line of the address.
      • line2s (object) - map of locale to value for the second line of the address.
    • area (object) - the neighborhood where the event takes place, e.g. “Little Italy”.
      • names (object) - map of locale to value for the names of the area.
    • city (object) - the city where the event takes place.
      • names (object) - map of locale to value for the names of the city.
    • country (object) - the country where the event takes place.
      • countryCode (string) - the code of the country of the event.
      • names (object) - map of locale to value for the names of the country.
    • location (object) - the event location’s latitude and longitude.
      • latitude (number) - the latitude of the event location.
      • longitude (number) - the longitude of the event location.
    • postalCode (string) - the postal code of the place of the event.
    • state (object) - the state (or region) where the event takes place.
      • names (object) - map of locale to value for the names of the state.
      • stateCode (string) - the code of the state of the event.
  • pleaseNotes (object) map of locale to value for any notes related to the event.
  • priceRanges (object) - price ranges of this event
    • type (string) - type of price (allowedValues:[“standard”])
    • currency (string) - currency code (as defined by ISO-4217)
    • min (number) - minimum price
    • max (number) - maximum price
  • promoter (object) - event’s promoter
    • id (string) - id of the promoter
    • names (object) map of locale to value for the names of the promoter
    • descriptions (object) map of locale to value for the descriptions of the promoter
  • publicVisibility (object) - determine if the event is visible on the Discovery API.
    • startDateTime (string) - the start date and time of visibility for this event on the Discovery API in UTC.
    • endDateTime (string) - the end date and time of visibility for this event on the Discovery API in UTC.
    • visible (boolean) - true if the event should be visible on the Discovery API, false otherwise. (if not specified: true)
  • sales (object) - sales dates information for the event.
    • public (object) - the public sales dates information for the event.
      • endDateTime (string) - the date and time of the end of the public sales period in UTC.
      • startDateTime (string) - the date and time of the start of the public sales period in UTC.
      • startTBD (boolean) - true if the public sale date start is to be determined, false otherwise.
  • source (object) - the id and source name of the event. Must be specified.
    • id (string) - the publisher’s id of the event.
    • name (string) - the publisher’s name.
    • publishingSource (object) - Optional. The id and name of the publishing source.
      • id (string) - the id of the event at the publishing source.
      • name (string) - the name of the publishing source.
  • test (boolean) - true if this is a test event data, false otherwise (real event).
  • url (string) - the URL of the event on the publisher’s site.
  • venue (object) - the venue of the event.
    • id (string) - the id of the venue as returned by the Discovery API. If specified, then the source element should not be set. Either id or source must be specified.
    • source (object) - the id and source name of the venue. Must be specified only if id is not. Either id or source must be specified.
      • id (string) - the publisher’s id of the venue.
      • name (string) - the publisher’s name.
  • version (number) - the publisher’s version for this event.

Response structure:

Success:

  • status (string) - status of the publication. Either Success or SuccessWarning(if there are any missing or unknown properties).
  • message (string) - warning message, if any
  • id (string) - the generated public id
  • missingProperties (object) - list of missing Preferred properties, if any.
  • unknownProperties (object) - list of unknown properties and their data, if any. Those properties won’t be visible in Discovery API.

Error:

  • errors (array) - list of errors.
    • status (string) - nature of the error. Either Error or Rejected(if there are any missing or unknown properties).
    • code (string) - the error code
    • detail (string) - the error message
    • invalidProperties (object) - list of invalid properties and their validation messages, if any
    • missingProperties (object) - list of missing Mandatory properties, if any

JavaScript cURL

$.ajax({
  type:"POST",
  url:"https://app.ticketmaster.com/publish/v2/events?apikey={apikey}",
  async:true,
  data: JSON.stringify({
    "source" : {
        "id" : "test_id_0009",
        "name" : "test-source"
    },
    "test": true,
    "names": {
        "en-us": "example test event tnt1"
    },
    "publicVisibility": {
        "startDateTime": "2015-10-29T15:00:00Z",
        "visible": true
    },
    "dates": {
        "start": {
            "dateTime": "2016-04-15T01:00:00Z",
            "localDate": "2016-04-14",
            "localTime": "19:00:00"
        },
        "timezone": "America/Edmonton"
    },
    "venue": {
        "source" : {
            "id" : "test_venue_id_0001",
            "name" : "test-source"
        }
    }
}),
  dataType: "json",
  success: function(json) {
              console.log(json);
              // Parse the response.
              // Do other things.
           },
  error: function(xhr, status, err) {
              // Manage exception
           }
});
curl -i -X POST 
--header "Content-Type: application/json" 
--header "Accept: application/json;charset=UTF-8" 
--header "TMPS-Correlation-Id: test1" 
-d "{
    \"source\" : {
        \"id\" : \"test_id_0009\",
        \"name\" : \"test-source\"
    },
    \"test\": true,
    \"names\": {
        \"en-us\": \"example test event tnt1\"
    },
    \"publicVisibility\": {
        \"startDateTime\": \"2015-10-29T15:00:00Z\",
        \"visible\": true
    },
    \"dates\": {
        \"start\": {
            \"dateTime\": \"2016-04-15T01:00:00Z\",
            \"localDate\": \"2016-04-14\",
            \"localTime\": \"19:00:00\"
        },
        \"timezone\": \"America/Edmonton\"
    },
    \"venue\": {
        \"source\" : {
            \"id\" : \"test_venue_id_0001\",
            \"name\" : \"test-source\"
        }
    }
}" "http://app.ticketmaster.com/publish/v2/events"

Http Response Codes

  • 200 - Success (may contain warnings)
    • Publication successful
    • Warnings, if any:
      • unknown properties - any properties unknown to Publish API.
      • missing properties - expected non-mandatory properties:
        • Venue or Place is preferred.
  • 400 - Rejected
    • Publication rejected due to missing/invalid properties or malformed request
    • Validation rules:
      • Id is generated and must not be provided
      • Venue and Place are mutually exclusive, only one should be provided.
      • Source is Mandatory
      • Source Name and Source Id are Mandatory and must contains only alphanumeric characters, dashes or underscores.
      • When Venue is provided, Venue Id and Venue Source are mandatory and mutually exclusive, either one must be provided.
        • No other properties are allowed for Venue.
        • When Venue Source is provided, Venue Source Name and Venue Source Id are Mandatory and must contains only alphanumeric characters, dashes or underscores.
      • When any Attraction is provided, Attraction Id and Attraction Source are mandatory and mutually exclusive, either one must be provided for each Attraction.
        • No other properties are allowed for Attraction.
        • When Attraction Source is provided, Attraction Source Name and Attraction Source Id are Mandatory and must contains only alphanumeric characters, dashes or underscores.
  • 500 - Error
    • Publication unsuccessful.
    • Internal Server Error.

Request Response

POST /publish/v2/events?apikey={apikey} HTTP/1.1
Host: app.ticketmaster.com
Content-Type: application/json;

{
  "additionalInfos": {
    "en-us": "string",
    "fr-ca": "chaine",
    "es-mx": "cuerda" 
  },
  "attractions": [
    {
      "source": {
        "id": "string",
        "name": "string"
      }
    }
  ],
  "dates": {
    "start": {
      "localDate": "2015-01-02",
      "localTime": "23:59:00",
      "dateTime": "2015-01-03T05:59:00Z",
      "dateTBD": false,
      "dateTBA": false,
      "timeTBA": false,
      "noSpecificTime": false
    },
    "access":{
      "startDateTime": "2015-01-03T05:59:00Z",
      "startApproximate": false,
      "endDateTime": "2015-01-03T05:59:00Z",
      "endApproximate": false
    },
    "end":{
      "localTime": "23:59:00",
      "dateTime": "2015-01-03T05:59:00Z",
      "approximate": false
    },
    "timezone": "America/Chicago"
  },
  "descriptions": {
    "en-us": "string",
    "fr-ca": "chaine",
    "es-mx": "cuerda" 
  },
  "images": [
    {
      "height": 0,
      "ratio": "string",
      "url": "string",
      "width": 0
    }
  ],
  "names": {
    "en-us": "string",
    "fr-ca": "chaine",
    "es-mx": "cuerda" 
  },
  "place": {
    "address": {
      "line1s": {
            "en-us": "string",
            "fr-ca": "chaine",
            "es-mx": "cuerda" 
      },
      "line2s": {
            "en-us": "string",
            "fr-ca": "chaine",
            "es-mx": "cuerda" 
      }
    },
    "area": {
      "names": {
            "en-us": "string",
            "fr-ca": "chaine",
            "es-mx": "cuerda" 
      }
    },
    "city": {
      "names": {
            "en-us": "string",
            "fr-ca": "chaine",
            "es-mx": "cuerda" 
      }
    },
    "country": {
      "countryCode": "string",
      "names": {
            "en-us": "string",
            "fr-ca": "chaine",
            "es-mx": "cuerda" 
      }
    },
    "location": {
      "latitude": 0,
      "longitude": 0
    },
    "postalCode": "string",
    "state": {
      "names": {
            "en-us": "string",
            "fr-ca": "chaine",
            "es-mx": "cuerda" 
      },
      "stateCode": "string"
    }
  },  
  "publicVisibility": {
    "startDateTime": "2014-12-03T01:59:00Z",
    "endDateTime": "2015-01-03T05:59:00Z",
    "visible": true
  },
  "sales": {
    "public": {
      "endDateTime": "2015-01-03T05:59:00Z",
      "startDateTime": "2014-12-03T01:59:00Z",
      "startTBD": false
    }
  },
  "source": {
    "id": "string",
    "name": "string"
  },
  "test": true,
  "venue": {
    "source": {
      "id": "string",
      "name": "string"
    }
  },
  "url": "string",
  "version": 0
}
HTTP/1.1 200 OK
Server: Apache-Coyote/1.1
Content-Type: application/json;charset=UTF-8
Content-Length: 43

{
  "status": "Success",
  "id": "ZuzyMmSiZzyMmSi"
}

Supported Markets

USA

ID Market
1 Birmingham & More
2 Charlotte
3 Chicagoland & Northern IL
4 Cincinnati & Dayton
5 Dallas - Fort Worth & More
6 Denver & More
7 Detroit, Toledo & More
8 El Paso & New Mexico
9 Grand Rapids & More
10 Greater Atlanta Area
11 Greater Boston Area
12 Cleveland, Youngstown & More
13 Greater Columbus Area
14 Greater Las Vegas Area
15 Greater Miami Area
16 Minneapolis/St. Paul & More
17 Greater Orlando Area
18 Greater Philadelphia Area
19 Greater Pittsburgh Area
20 Greater San Diego Area
21 Greater Tampa Area
22 Houston & More
23 Indianapolis & More
24 Iowa
25 Jacksonville & More
26 Kansas City & More
27 Greater Los Angeles Area
28 Louisville & Lexington
29 Memphis, Little Rock & More
30 Milwaukee & WI
31 Nashville, Knoxville & More
32 United States
33 New England
34 New Orleans & More
35 New York/Tri-State Area
36 Phoenix & Tucson
37 Portland & More
38 Raleigh & Durham
39 Saint Louis & More
40 San Antonio & Austin
41 N. California/N. Nevada
42 Greater Seattle Area
43 North & South Dakota
44 Upstate New York
45 Utah & Montana
46 Virginia
47 Washington, DC and Maryland
48 West Virginia
49 Hawaii
50 Alaska
51 All of US
52 Nebraska
53 Springfield
54 Central Illinois
55 Northern New Jersey
121 South Carolina
122 South Texas
123 Beaumont
124 Connecticut
125 Oklahoma

Canada

ID Market
101 All of Canada
102 Toronto, Hamilton & Area
103 Ottawa & Eastern Ontario
106 Manitoba
107 Edmonton & Northern Alberta
108 Calgary & Southern Alberta
110 B.C. Interior
111 Vancouver & Area
112 Saskatchewan
120 Montréal & Area

Europe

ID Market
201 All of United Kingdom
202 London
203 South
204 Midlands and Central
205 Wales and North West
206 North and North East
207 Scotland
208 Ireland
209 Northern Ireland
210 Germany
211 Netherlands
500 Sweden
501 Todas las poblaciones
502 Barcelona
503 Madrid
600 Turkey

Australia and New Zealand

ID Market
301 All of Australia
302 New South Wales/Australian Capital Territory
303 Queensland
304 Western Australi
305 Victoria/Tasmania
306 Western Australia
350 All of New Zealand
351 North Island
352 South Island

Mexico

ID Market
401 All of Mexico
402 Mexico City and Metropolitan Area
403 Monterrey
404 Guadalajara

Supported Sources

Source
ticketweb
universe
frontgate

Supported Locales

We support all languages, without any fallback.