Update an event

Content

Resource URL

https://apps.ticketmatic.com/api/1/{accountname}/events/{id}

Example

Request

  1use Ticketmatic\Endpoints\Events;
  2
  3$result = Events::update($client, $id, array(
  4    "name" => "Bonobo Live",
  5    "audiopreviewurl" => "https://s3-eu-west-1.amazonaws.com/filestore-ticketmatic-com/test/9876/events/1234/image.jpg",
  6    "contingents" => array(
  7        array(
  8            "id" => 98,
  9            "name" => "Tickets",
 10            "amount" => 100,
 11            "eventid" => 777701,
 12            "eventspecificprices" => null,
 13            "locks" => array(
 14            ),
 15            "pricelistid" => 6,
 16            "withimportedbarcodes" => false,
 17        ),
 18    ),
 19    "currentstatus" => 19001,
 20    "description" => "Panda Dub, leading man of the french dub scene returns with a new show: Circle Live!",
 21    "endts" => "2014-09-26 15:24:36",
 22    "externalcode" => "56975647832",
 23    "info" => "Lockers available in the basement.",
 24    "layout" => array(
 25        "color" => "#112233",
 26        "maxImage" => true,
 27    ),
 28    "locationid" => 125,
 29    "maxnbrofticketsperbasket" => 5,
 30    "optinsetid" => 125,
 31    "previews" => array(
 32        array(
 33            "type" => 30002,
 34            "url" => "https://www.youtube.com/watch?v=RIGgn1s3AvI",
 35        ),
 36        array(
 37            "type" => 30002,
 38            "url" => "https://www.youtube.com/watch?v=6VrqR_GfvzE",
 39        ),
 40        array(
 41            "type" => 30003,
 42            "url" => "https://w.soundcloud.com/player/?url=https%3A//api.soundcloud.com/tracks/356544932&color=%23ff5500&auto_play=false&hide_related=false&show_comments=true&show_user=true&show_reposts=false&show_teaser=true&visual=true",
 43        ),
 44    ),
 45    "productionid" => 1.256975647e+09,
 46    "queuetoken" => 421,
 47    "revenuesplitid" => 125,
 48    "saleendts" => "2014-09-26 15:24:36",
 49    "saleschannels" => array(
 50        array(
 51            "eventid" => 123,
 52            "haswaitinglist" => false,
 53            "isactive" => true,
 54            "saleendts" => "2014-09-26 15:24:36",
 55            "saleschannelid" => 1,
 56            "salestartts" => null,
 57        ),
 58    ),
 59    "salestartts" => "2014-09-26 15:24:36",
 60    "salestatusmessagesid" => 125,
 61    "schedule" => "20:00 support act\n21:00 show\n22:30 end",
 62    "seatallowsingle" => false,
 63    "seated_chartkey" => "",
 64    "seated_contingents" => array(
 65        array(
 66            "id" => 98,
 67            "name" => "Tickets",
 68            "amount" => 100,
 69            "eventid" => 777701,
 70            "eventspecificprices" => null,
 71            "locks" => array(
 72            ),
 73            "pricelistid" => 6,
 74            "withimportedbarcodes" => false,
 75        ),
 76    ),
 77    "seatingplaneventspecificprices" => array(
 78        "prices" => array(
 79            array(
 80                "availabilities" => array(
 81                    true,
 82                ),
 83                "position" => 3,
 84                "prices" => array(
 85                    25,
 86                ),
 87                "pricetypeid" => 1,
 88                "saleschannels" => array(
 89                    1,
 90                    2,
 91                ),
 92            ),
 93            array(
 94                "availabilities" => array(
 95                    true,
 96                ),
 97                "conditions" => array(
 98                    array(
 99                        "type" => "promocode",
100                        "value" => "UGENT2013",
101                    ),
102                ),
103                "position" => 7,
104                "prices" => array(
105                    30,
106                ),
107                "pricetypeid" => 2,
108                "saleschannels" => array(
109                    1,
110                    2,
111                ),
112            ),
113        ),
114        "seatrankids" => null,
115    ),
116    "seatingplanid" => 125,
117    "seatingplanlocktemplate" => "Default",
118    "seatingplanpricelistid" => 125,
119    "seatselection" => false,
120    "segmentationtags" => array(
121        "tag1",
122        "tag2",
123    ),
124    "servicemailids" => array(
125        1,
126        2,
127    ),
128    "shortdescription" => "Panda Dub, leading man of the french dub scene returns with a new show: Circle Live!",
129    "socialdistance" => 50001,
130    "startts" => "2014-09-26 15:24:36",
131    "subtitle" => "With live band",
132    "subtitle2" => "Exclusive concert",
133    "tags" => array(
134        "event tag1",
135        "event tag2",
136    ),
137    "ticketfeeid" => 125,
138    "ticketinfoid" => 125,
139    "ticketlayoutid" => 125,
140    "totalmaxtickets" => 1000,
141    "translations" => array(
142        "nameen" => "English name",
143        "namefr" => "Nom francais",
144    ),
145    "upsellid" => 125,
146    "waitinglisttype" => 29001,
147    "webremark" => "Age will be checked at the entrance",
148));

Response

  1object(\Ticketmatic\Model\Event) (54) {
  2  ["id"]=>
  3  int(0)
  4  ["name"]=>
  5  string(11) "Bonobo Live"
  6  ["audiopreviewurl"]=>
  7  string(92) "https://s3-eu-west-1.amazonaws.com/filestore-ticketmatic-com/test/9876/events/1234/image.jpg"
  8  ["availability"]=>
  9  array(1) {
 10    [0]=>
 11    object(\Ticketmatic\Model\EventContingentAvailability) (10) {
 12      ["complimentary"]=>
 13      int(0)
 14      ["free"]=>
 15      int(0)
 16      ["locked_hard"]=>
 17      int(0)
 18      ["locked_soft"]=>
 19      int(0)
 20      ["reserved"]=>
 21      int(0)
 22      ["sold_paid"]=>
 23      int(0)
 24      ["sold_unpaid"]=>
 25      int(0)
 26      ["tickettypeid"]=>
 27      int(0)
 28      ["total"]=>
 29      int(0)
 30      ["lastupdatets"]=>
 31      object(\DateTime) (3) {
 32        ["date"]=>
 33        string(26) "2015-05-29 09:21:10.38252.000000"
 34        ["timezone_type"]=>
 35        int(3)
 36        ["timezone"]=>
 37        string(3) "UTC"
 38      }
 39    }
 40  }
 41  ["code"]=>
 42  string(12) "864056970700"
 43  ["contingents"]=>
 44  array(1) {
 45    [0]=>
 46    object(\Ticketmatic\Model\EventContingent) (8) {
 47      ["id"]=>
 48      int(0)
 49      ["name"]=>
 50      string(7) "Tickets"
 51      ["amount"]=>
 52      int(0)
 53      ["eventid"]=>
 54      int(0)
 55      ["eventspecificprices"]=>
 56      NULL
 57      ["locks"]=>
 58      array(0) {
 59      }
 60      ["pricelistid"]=>
 61      int(0)
 62      ["withimportedbarcodes"]=>
 63      bool(false)
 64    }
 65  }
 66  ["currentstatus"]=>
 67  int(0)
 68  ["description"]=>
 69  string(84) "Panda Dub, leading man of the french dub scene returns with a new show: Circle Live!"
 70  ["endts"]=>
 71  object(\DateTime) (3) {
 72    ["date"]=>
 73    string(26) "2014-09-26 15:24:36.000000"
 74    ["timezone_type"]=>
 75    int(3)
 76    ["timezone"]=>
 77    string(3) "UTC"
 78  }
 79  ["externalcode"]=>
 80  string(11) "56975647832"
 81  ["image"]=>
 82  string(92) "https://s3-eu-west-1.amazonaws.com/filestore-ticketmatic-com/test/9876/events/1234/image.jpg"
 83  ["info"]=>
 84  string(34) "Lockers available in the basement."
 85  ["layout"]=>
 86  object(\Ticketmatic\Model\Layout) (2) {
 87    ["color"]=>
 88    string(7) "#112233"
 89    ["maxImage"]=>
 90    bool(true)
 91  }
 92  ["locationid"]=>
 93  int(0)
 94  ["locationname"]=>
 95  string(12) "Concert hall"
 96  ["maxnbrofticketsperbasket"]=>
 97  int(0)
 98  ["optinsetid"]=>
 99  int(0)
100  ["previews"]=>
101  array(3) {
102    [0]=>
103    object(\Ticketmatic\Model\EventPreview) (2) {
104      ["type"]=>
105      int(0)
106      ["url"]=>
107      string(43) "https://www.youtube.com/watch?v=RIGgn1s3AvI"
108    }
109    [1]=>
110    object(\Ticketmatic\Model\EventPreview) (2) {
111      ["type"]=>
112      int(0)
113      ["url"]=>
114      string(43) "https://www.youtube.com/watch?v=6VrqR_GfvzE"
115    }
116    [2]=>
117    object(\Ticketmatic\Model\EventPreview) (2) {
118      ["type"]=>
119      int(0)
120      ["url"]=>
121      string(215) "https://w.soundcloud.com/player/?url=https%3A//api.soundcloud.com/tracks/356544932&color=%23ff5500&auto_play=false&hide_related=false&show_comments=true&show_user=true&show_reposts=false&show_teaser=true&visual=true"
122    }
123  }
124  ["prices"]=>
125  object(\Ticketmatic\Model\EventPrices) (1) {
126    ["contingents"]=>
127    array(1) {
128      [0]=>
129      object(\Ticketmatic\Model\EventPricesContingent) (2) {
130        ["contingentid"]=>
131        int(0)
132        ["pricetypes"]=>
133        array(1) {
134          [0]=>
135          object(\Ticketmatic\Model\EventPricesPricetype) (2) {
136            ["pricetypeid"]=>
137            int(0)
138            ["saleschannels"]=>
139            array(1) {
140              [0]=>
141              object(\Ticketmatic\Model\EventPricesSaleschannel) (5) {
142                ["costs"]=>
143                array(1) {
144                  [0]=>
145                  object(\Ticketmatic\Model\EventPricesCost) (2) {
146                    ["cost"]=>
147                    float(5.000000)
148                    ["costid"]=>
149                    int(0)
150                  }
151                }
152                ["price"]=>
153                float(30.500000)
154                ["saleschannelid"]=>
155                int(0)
156                ["servicecharge"]=>
157                float(1.500000)
158                ["tickettypepriceid"]=>
159                int(0)
160              }
161            }
162          }
163        }
164      }
165    }
166  }
167  ["productionid"]=>
168  int(0)
169  ["publishedts"]=>
170  object(\DateTime) (3) {
171    ["date"]=>
172    string(26) "2014-09-26 15:24:36.000000"
173    ["timezone_type"]=>
174    int(3)
175    ["timezone"]=>
176    string(3) "UTC"
177  }
178  ["queuetoken"]=>
179  int(0)
180  ["revenuesplitid"]=>
181  int(0)
182  ["saleendts"]=>
183  object(\DateTime) (3) {
184    ["date"]=>
185    string(26) "2014-09-26 15:24:36.000000"
186    ["timezone_type"]=>
187    int(3)
188    ["timezone"]=>
189    string(3) "UTC"
190  }
191  ["saleschannels"]=>
192  array(1) {
193    [0]=>
194    object(\Ticketmatic\Model\EventSalesChannel) (6) {
195      ["eventid"]=>
196      int(0)
197      ["haswaitinglist"]=>
198      bool(false)
199      ["isactive"]=>
200      bool(true)
201      ["saleendts"]=>
202      object(\DateTime) (3) {
203        ["date"]=>
204        string(26) "2014-09-26 15:24:36.000000"
205        ["timezone_type"]=>
206        int(3)
207        ["timezone"]=>
208        string(3) "UTC"
209      }
210      ["saleschannelid"]=>
211      int(0)
212      ["salestartts"]=>
213      NULL
214    }
215  }
216  ["salestartts"]=>
217  object(\DateTime) (3) {
218    ["date"]=>
219    string(26) "2014-09-26 15:24:36.000000"
220    ["timezone_type"]=>
221    int(3)
222    ["timezone"]=>
223    string(3) "UTC"
224  }
225  ["salestatusmessagesid"]=>
226  int(0)
227  ["schedule"]=>
228  string(38) "20:00 support act
22921:00 show
23022:30 end"
231  ["seatallowsingle"]=>
232  bool(false)
233  ["seated_chartkey"]=>
234  string(0) ""
235  ["seated_contingents"]=>
236  array(1) {
237    [0]=>
238    object(\Ticketmatic\Model\EventContingent) (8) {
239      ["id"]=>
240      int(0)
241      ["name"]=>
242      string(7) "Tickets"
243      ["amount"]=>
244      int(0)
245      ["eventid"]=>
246      int(0)
247      ["eventspecificprices"]=>
248      NULL
249      ["locks"]=>
250      array(0) {
251      }
252      ["pricelistid"]=>
253      int(0)
254      ["withimportedbarcodes"]=>
255      bool(false)
256    }
257  }
258  ["seatingplancontingents"]=>
259  array(2) {
260    [0]=>
261    object(\Ticketmatic\Model\EventSeatingplanContingent) (5) {
262      ["id"]=>
263      int(0)
264      ["name"]=>
265      string(6) "Name A"
266      ["amount"]=>
267      int(0)
268      ["eventid"]=>
269      int(0)
270      ["seatrankid"]=>
271      int(0)
272    }
273    [1]=>
274    object(\Ticketmatic\Model\EventSeatingplanContingent) (5) {
275      ["id"]=>
276      int(0)
277      ["name"]=>
278      string(6) "Name B"
279      ["amount"]=>
280      int(0)
281      ["eventid"]=>
282      int(0)
283      ["seatrankid"]=>
284      int(0)
285    }
286  }
287  ["seatingplaneventspecificprices"]=>
288  object(\Ticketmatic\Model\PricelistPrices) (2) {
289    ["prices"]=>
290    array(2) {
291      [0]=>
292      object(\Ticketmatic\Model\PricelistPrice) (5) {
293        ["availabilities"]=>
294        array(1) {
295          [0]=>
296          bool(true)
297        }
298        ["position"]=>
299        int(0)
300        ["prices"]=>
301        array(1) {
302          [0]=>
303          float(25.000000)
304        }
305        ["pricetypeid"]=>
306        int(0)
307        ["saleschannels"]=>
308        array(2) {
309          [0]=>
310          int(0)
311          [1]=>
312          int(0)
313        }
314      }
315      [1]=>
316      object(\Ticketmatic\Model\PricelistPrice) (6) {
317        ["availabilities"]=>
318        array(1) {
319          [0]=>
320          bool(true)
321        }
322        ["conditions"]=>
323        array(1) {
324          [0]=>
325          object(\Ticketmatic\Model\PricelistPriceCondition) (2) {
326            ["type"]=>
327            string(9) "promocode"
328            ["value"]=>
329            string(9) "UGENT2013"
330          }
331        }
332        ["position"]=>
333        int(0)
334        ["prices"]=>
335        array(1) {
336          [0]=>
337          float(30.000000)
338        }
339        ["pricetypeid"]=>
340        int(0)
341        ["saleschannels"]=>
342        array(2) {
343          [0]=>
344          int(0)
345          [1]=>
346          int(0)
347        }
348      }
349    }
350    ["seatrankids"]=>
351    NULL
352  }
353  ["seatingplanid"]=>
354  int(0)
355  ["seatingplanpricelistid"]=>
356  int(0)
357  ["seatselection"]=>
358  bool(false)
359  ["segmentationtags"]=>
360  array(2) {
361    [0]=>
362    string(4) "tag1"
363    [1]=>
364    string(4) "tag2"
365  }
366  ["servicemailids"]=>
367  array(2) {
368    [0]=>
369    int(0)
370    [1]=>
371    int(0)
372  }
373  ["shortdescription"]=>
374  string(84) "Panda Dub, leading man of the french dub scene returns with a new show: Circle Live!"
375  ["socialdistance"]=>
376  int(0)
377  ["startts"]=>
378  object(\DateTime) (3) {
379    ["date"]=>
380    string(26) "2014-09-26 15:24:36.000000"
381    ["timezone_type"]=>
382    int(3)
383    ["timezone"]=>
384    string(3) "UTC"
385  }
386  ["subtitle"]=>
387  string(14) "With live band"
388  ["subtitle2"]=>
389  string(17) "Exclusive concert"
390  ["tags"]=>
391  array(2) {
392    [0]=>
393    string(10) "event tag1"
394    [1]=>
395    string(10) "event tag2"
396  }
397  ["ticketfeeid"]=>
398  int(0)
399  ["ticketinfoid"]=>
400  int(0)
401  ["ticketlayoutid"]=>
402  int(0)
403  ["totalmaxtickets"]=>
404  int(0)
405  ["translations"]=>
406  array(2) {
407    ["nameen"]=>
408    string(12) "English name"
409    ["namefr"]=>
410    string(12) "Nom francais"
411  }
412  ["upsellid"]=>
413  int(0)
414  ["waitinglisttype"]=>
415  int(0)
416  ["webremark"]=>
417  string(35) "Age will be checked at the entrance"
418  ["createdts"]=>
419  object(\DateTime) (3) {
420    ["date"]=>
421    string(26) "2014-09-26 15:24:36.000000"
422    ["timezone_type"]=>
423    int(3)
424    ["timezone"]=>
425    string(3) "UTC"
426  }
427  ["lastupdatets"]=>
428  object(\DateTime) (3) {
429    ["date"]=>
430    string(26) "2014-09-26 15:24:36.000000"
431    ["timezone_type"]=>
432    int(3)
433    ["timezone"]=>
434    string(3) "UTC"
435  }
436}

Request

  1import (
  2    "github.com/ticketmatic/tm-go/ticketmatic"
  3    "github.com/ticketmatic/tm-go/ticketmatic/events"
  4)
  5
  6result, err := events.Update(client, id, &ticketmatic.Event{
  7    Name: "Bonobo Live",
  8    Audiopreviewurl: "https://s3-eu-west-1.amazonaws.com/filestore-ticketmatic-com/test/9876/events/1234/image.jpg",
  9    Contingents: []*ticketmatic.EventContingent{
 10        &ticketmatic.EventContingent{
 11            Id: 98,
 12            Name: "Tickets",
 13            Amount: 100,
 14            Eventid: 777701,
 15            Eventspecificprices: nil,
 16            Locks: []*ticketmatic.EventContingentLock{
 17            },
 18            Pricelistid: 6,
 19            Withimportedbarcodes: false,
 20        },
 21    },
 22    Currentstatus: 19001,
 23    Description: "Panda Dub, leading man of the french dub scene returns with a new show: Circle Live!",
 24    Endts: ticketmatic.NewTime(ticketmatic.MustParseTime("2014-09-26 15:24:36")),
 25    Externalcode: "56975647832",
 26    Info: "Lockers available in the basement.",
 27    Layout: &ticketmatic.Layout{
 28        Color: "#112233",
 29        MaxImage: true,
 30    },
 31    Locationid: 125,
 32    Maxnbrofticketsperbasket: 5,
 33    Optinsetid: 125,
 34    Previews: []*ticketmatic.EventPreview{
 35        &ticketmatic.EventPreview{
 36            Type: 30002,
 37            Url: "https://www.youtube.com/watch?v=RIGgn1s3AvI",
 38        },
 39        &ticketmatic.EventPreview{
 40            Type: 30002,
 41            Url: "https://www.youtube.com/watch?v=6VrqR_GfvzE",
 42        },
 43        &ticketmatic.EventPreview{
 44            Type: 30003,
 45            Url: "https://w.soundcloud.com/player/?url=https%3A//api.soundcloud.com/tracks/356544932&color=%23ff5500&auto_play=false&hide_related=false&show_comments=true&show_user=true&show_reposts=false&show_teaser=true&visual=true",
 46        },
 47    },
 48    Productionid: 1256975647,
 49    Queuetoken: 421,
 50    Revenuesplitid: 125,
 51    Saleendts: ticketmatic.NewTime(ticketmatic.MustParseTime("2014-09-26 15:24:36")),
 52    Saleschannels: []*ticketmatic.EventSalesChannel{
 53        &ticketmatic.EventSalesChannel{
 54            Eventid: 123,
 55            Haswaitinglist: false,
 56            Isactive: true,
 57            Saleendts: ticketmatic.NewTime(ticketmatic.MustParseTime("2014-09-26 15:24:36")),
 58            Saleschannelid: 1,
 59            Salestartts: ticketmatic.NewTime(ticketmatic.MustParseTime(<nil>)),
 60        },
 61    },
 62    Salestartts: ticketmatic.NewTime(ticketmatic.MustParseTime("2014-09-26 15:24:36")),
 63    Salestatusmessagesid: 125,
 64    Schedule: "20:00 support act\n21:00 show\n22:30 end",
 65    Seatallowsingle: false,
 66    SeatedChartkey: "",
 67    SeatedContingents: []*ticketmatic.EventContingent{
 68        &ticketmatic.EventContingent{
 69            Id: 98,
 70            Name: "Tickets",
 71            Amount: 100,
 72            Eventid: 777701,
 73            Eventspecificprices: nil,
 74            Locks: []*ticketmatic.EventContingentLock{
 75            },
 76            Pricelistid: 6,
 77            Withimportedbarcodes: false,
 78        },
 79    },
 80    Seatingplaneventspecificprices: &ticketmatic.PricelistPrices{
 81        Prices: []*ticketmatic.PricelistPrice{
 82            &ticketmatic.PricelistPrice{
 83                Availabilities: []bool{
 84                    true,
 85                },
 86                Position: 3,
 87                Prices: []float64{
 88                    25,
 89                },
 90                Pricetypeid: 1,
 91                Saleschannels: []int64{
 92                    1,
 93                    2,
 94                },
 95            },
 96            &ticketmatic.PricelistPrice{
 97                Availabilities: []bool{
 98                    true,
 99                },
100                Conditions: []*ticketmatic.PricelistPriceCondition{
101                    &ticketmatic.PricelistPriceCondition{
102                        Type: "promocode",
103                        Value: "UGENT2013",
104                    },
105                },
106                Position: 7,
107                Prices: []float64{
108                    30,
109                },
110                Pricetypeid: 2,
111                Saleschannels: []int64{
112                    1,
113                    2,
114                },
115            },
116        },
117        Seatrankids: nil,
118    },
119    Seatingplanid: 125,
120    Seatingplanlocktemplate: "Default",
121    Seatingplanpricelistid: 125,
122    Seatselection: false,
123    Segmentationtags: []string{
124        "tag1",
125        "tag2",
126    },
127    Servicemailids: []int64{
128        1,
129        2,
130    },
131    Shortdescription: "Panda Dub, leading man of the french dub scene returns with a new show: Circle Live!",
132    Socialdistance: 50001,
133    Startts: ticketmatic.NewTime(ticketmatic.MustParseTime("2014-09-26 15:24:36")),
134    Subtitle: "With live band",
135    Subtitle2: "Exclusive concert",
136    Tags: []string{
137        "event tag1",
138        "event tag2",
139    },
140    Ticketfeeid: 125,
141    Ticketinfoid: 125,
142    Ticketlayoutid: 125,
143    Totalmaxtickets: 1000,
144    Translations: map[string]string{
145        "nameen": "English name",
146        "namefr": "Nom francais",
147    },
148    Upsellid: 125,
149    Waitinglisttype: 29001,
150    Webremark: "Age will be checked at the entrance",
151})

Response

  1result := &ticketmatic.Event{
  2    Id: 1269434,
  3    Name: "Bonobo Live",
  4    Audiopreviewurl: "https://s3-eu-west-1.amazonaws.com/filestore-ticketmatic-com/test/9876/events/1234/image.jpg",
  5    Availability: []*ticketmatic.EventContingentAvailability{
  6        &ticketmatic.EventContingentAvailability{
  7            Complimentary: 0,
  8            Free: 815,
  9            LockedHard: 10,
 10            LockedSoft: 15,
 11            Reserved: 0,
 12            SoldPaid: 0,
 13            SoldUnpaid: 0,
 14            Tickettypeid: 89,
 15            Total: 840,
 16            Lastupdatets: ticketmatic.NewTime(ticketmatic.MustParseTime("2015-05-29 09:21:10.38252")),
 17        },
 18    },
 19    Code: "864056970700",
 20    Contingents: []*ticketmatic.EventContingent{
 21        &ticketmatic.EventContingent{
 22            Id: 98,
 23            Name: "Tickets",
 24            Amount: 100,
 25            Eventid: 777701,
 26            Eventspecificprices: nil,
 27            Locks: []*ticketmatic.EventContingentLock{
 28            },
 29            Pricelistid: 6,
 30            Withimportedbarcodes: false,
 31        },
 32    },
 33    Currentstatus: 19001,
 34    Description: "Panda Dub, leading man of the french dub scene returns with a new show: Circle Live!",
 35    Endts: ticketmatic.NewTime(ticketmatic.MustParseTime("2014-09-26 15:24:36")),
 36    Externalcode: "56975647832",
 37    Image: "https://s3-eu-west-1.amazonaws.com/filestore-ticketmatic-com/test/9876/events/1234/image.jpg",
 38    Info: "Lockers available in the basement.",
 39    Layout: &ticketmatic.Layout{
 40        Color: "#112233",
 41        MaxImage: true,
 42    },
 43    Locationid: 125,
 44    Locationname: "Concert hall",
 45    Maxnbrofticketsperbasket: 5,
 46    Optinsetid: 125,
 47    Previews: []*ticketmatic.EventPreview{
 48        &ticketmatic.EventPreview{
 49            Type: 30002,
 50            Url: "https://www.youtube.com/watch?v=RIGgn1s3AvI",
 51        },
 52        &ticketmatic.EventPreview{
 53            Type: 30002,
 54            Url: "https://www.youtube.com/watch?v=6VrqR_GfvzE",
 55        },
 56        &ticketmatic.EventPreview{
 57            Type: 30003,
 58            Url: "https://w.soundcloud.com/player/?url=https%3A//api.soundcloud.com/tracks/356544932&color=%23ff5500&auto_play=false&hide_related=false&show_comments=true&show_user=true&show_reposts=false&show_teaser=true&visual=true",
 59        },
 60    },
 61    Prices: &ticketmatic.EventPrices{
 62        Contingents: []*ticketmatic.EventPricesContingent{
 63            &ticketmatic.EventPricesContingent{
 64                Contingentid: 1,
 65                Pricetypes: []*ticketmatic.EventPricesPricetype{
 66                    &ticketmatic.EventPricesPricetype{
 67                        Pricetypeid: 2,
 68                        Saleschannels: []*ticketmatic.EventPricesSaleschannel{
 69                            &ticketmatic.EventPricesSaleschannel{
 70                                Costs: []*ticketmatic.EventPricesCost{
 71                                    &ticketmatic.EventPricesCost{
 72                                        Cost: 5,
 73                                        Costid: 0,
 74                                    },
 75                                },
 76                                Price: 30.5,
 77                                Saleschannelid: 3,
 78                                Servicecharge: 1.5,
 79                                Tickettypepriceid: 4,
 80                            },
 81                        },
 82                    },
 83                },
 84            },
 85        },
 86    },
 87    Productionid: 1256975647,
 88    Publishedts: ticketmatic.NewTime(ticketmatic.MustParseTime("2014-09-26 15:24:36")),
 89    Queuetoken: 421,
 90    Revenuesplitid: 125,
 91    Saleendts: ticketmatic.NewTime(ticketmatic.MustParseTime("2014-09-26 15:24:36")),
 92    Saleschannels: []*ticketmatic.EventSalesChannel{
 93        &ticketmatic.EventSalesChannel{
 94            Eventid: 123,
 95            Haswaitinglist: false,
 96            Isactive: true,
 97            Saleendts: ticketmatic.NewTime(ticketmatic.MustParseTime("2014-09-26 15:24:36")),
 98            Saleschannelid: 1,
 99            Salestartts: ticketmatic.NewTime(ticketmatic.MustParseTime(<nil>)),
100        },
101    },
102    Salestartts: ticketmatic.NewTime(ticketmatic.MustParseTime("2014-09-26 15:24:36")),
103    Salestatusmessagesid: 125,
104    Schedule: "20:00 support act\n21:00 show\n22:30 end",
105    Seatallowsingle: false,
106    SeatedChartkey: "",
107    SeatedContingents: []*ticketmatic.EventContingent{
108        &ticketmatic.EventContingent{
109            Id: 98,
110            Name: "Tickets",
111            Amount: 100,
112            Eventid: 777701,
113            Eventspecificprices: nil,
114            Locks: []*ticketmatic.EventContingentLock{
115            },
116            Pricelistid: 6,
117            Withimportedbarcodes: false,
118        },
119    },
120    Seatingplancontingents: []*ticketmatic.EventSeatingplanContingent{
121        &ticketmatic.EventSeatingplanContingent{
122            Id: 99,
123            Name: "Name A",
124            Amount: 50,
125            Eventid: 777702,
126            Seatrankid: 1,
127        },
128        &ticketmatic.EventSeatingplanContingent{
129            Id: 100,
130            Name: "Name B",
131            Amount: 50,
132            Eventid: 777702,
133            Seatrankid: 2,
134        },
135    },
136    Seatingplaneventspecificprices: &ticketmatic.PricelistPrices{
137        Prices: []*ticketmatic.PricelistPrice{
138            &ticketmatic.PricelistPrice{
139                Availabilities: []bool{
140                    true,
141                },
142                Position: 3,
143                Prices: []float64{
144                    25,
145                },
146                Pricetypeid: 1,
147                Saleschannels: []int64{
148                    1,
149                    2,
150                },
151            },
152            &ticketmatic.PricelistPrice{
153                Availabilities: []bool{
154                    true,
155                },
156                Conditions: []*ticketmatic.PricelistPriceCondition{
157                    &ticketmatic.PricelistPriceCondition{
158                        Type: "promocode",
159                        Value: "UGENT2013",
160                    },
161                },
162                Position: 7,
163                Prices: []float64{
164                    30,
165                },
166                Pricetypeid: 2,
167                Saleschannels: []int64{
168                    1,
169                    2,
170                },
171            },
172        },
173        Seatrankids: nil,
174    },
175    Seatingplanid: 125,
176    Seatingplanpricelistid: 125,
177    Seatselection: false,
178    Segmentationtags: []string{
179        "tag1",
180        "tag2",
181    },
182    Servicemailids: []int64{
183        1,
184        2,
185    },
186    Shortdescription: "Panda Dub, leading man of the french dub scene returns with a new show: Circle Live!",
187    Socialdistance: 50001,
188    Startts: ticketmatic.NewTime(ticketmatic.MustParseTime("2014-09-26 15:24:36")),
189    Subtitle: "With live band",
190    Subtitle2: "Exclusive concert",
191    Tags: []string{
192        "event tag1",
193        "event tag2",
194    },
195    Ticketfeeid: 125,
196    Ticketinfoid: 125,
197    Ticketlayoutid: 125,
198    Totalmaxtickets: 1000,
199    Translations: map[string]string{
200        "nameen": "English name",
201        "namefr": "Nom francais",
202    },
203    Upsellid: 125,
204    Waitinglisttype: 29001,
205    Webremark: "Age will be checked at the entrance",
206    Createdts: ticketmatic.NewTime(ticketmatic.MustParseTime("2014-09-26 15:24:36")),
207    Lastupdatets: ticketmatic.NewTime(ticketmatic.MustParseTime("2014-09-26 15:24:36")),
208}

Request

  1PUT /api/1/{accountname}/events/{id} HTTP/1.1
  2Content-Type: application/json
  3
  4{
  5    "name": "Bonobo Live",
  6    "audiopreviewurl": "https://s3-eu-west-1.amazonaws.com/filestore-ticketmatic-com/test/9876/events/1234/image.jpg",
  7    "contingents": [
  8        {
  9            "id": 98,
 10            "name": "Tickets",
 11            "amount": 100,
 12            "eventid": 777701,
 13            "eventspecificprices": null,
 14            "locks": [],
 15            "pricelistid": 6,
 16            "withimportedbarcodes": false
 17        }
 18    ],
 19    "currentstatus": 19001,
 20    "description": "Panda Dub, leading man of the french dub scene returns with a new show: Circle Live!",
 21    "endts": "2014-09-26 15:24:36",
 22    "externalcode": "56975647832",
 23    "info": "Lockers available in the basement.",
 24    "layout": {
 25        "color": "#112233",
 26        "maxImage": true
 27    },
 28    "locationid": 125,
 29    "maxnbrofticketsperbasket": 5,
 30    "optinsetid": 125,
 31    "previews": [
 32        {
 33            "type": 30002,
 34            "url": "https://www.youtube.com/watch?v=RIGgn1s3AvI"
 35        },
 36        {
 37            "type": 30002,
 38            "url": "https://www.youtube.com/watch?v=6VrqR_GfvzE"
 39        },
 40        {
 41            "type": 30003,
 42            "url": "https://w.soundcloud.com/player/?url=https%3A//api.soundcloud.com/tracks/356544932&color=%23ff5500&auto_play=false&hide_related=false&show_comments=true&show_user=true&show_reposts=false&show_teaser=true&visual=true"
 43        }
 44    ],
 45    "productionid": 1256975647,
 46    "queuetoken": 421,
 47    "revenuesplitid": 125,
 48    "saleendts": "2014-09-26 15:24:36",
 49    "saleschannels": [
 50        {
 51            "eventid": 123,
 52            "haswaitinglist": false,
 53            "isactive": true,
 54            "saleendts": "2014-09-26 15:24:36",
 55            "saleschannelid": 1,
 56            "salestartts": null
 57        }
 58    ],
 59    "salestartts": "2014-09-26 15:24:36",
 60    "salestatusmessagesid": 125,
 61    "schedule": "20:00 support act
 6221:00 show
 6322:30 end",
 64    "seatallowsingle": false,
 65    "seated_chartkey": "",
 66    "seated_contingents": [
 67        {
 68            "id": 98,
 69            "name": "Tickets",
 70            "amount": 100,
 71            "eventid": 777701,
 72            "eventspecificprices": null,
 73            "locks": [],
 74            "pricelistid": 6,
 75            "withimportedbarcodes": false
 76        }
 77    ],
 78    "seatingplaneventspecificprices": {
 79        "prices": [
 80            {
 81                "availabilities": [
 82                    true
 83                ],
 84                "position": 3,
 85                "prices": [ 25.000000 ],
 86                "pricetypeid": 1,
 87                "saleschannels": [ 1, 2 ]
 88            },
 89            {
 90                "availabilities": [
 91                    true
 92                ],
 93                "conditions": [
 94                    {
 95                        "type": "promocode",
 96                        "value": "UGENT2013"
 97                    }
 98                ],
 99                "position": 7,
100                "prices": [ 30.000000 ],
101                "pricetypeid": 2,
102                "saleschannels": [ 1, 2 ]
103            }
104        ],
105        "seatrankids": null
106    },
107    "seatingplanid": 125,
108    "seatingplanlocktemplate": "Default",
109    "seatingplanpricelistid": 125,
110    "seatselection": false,
111    "segmentationtags": [
112        "tag1",
113        "tag2"
114    ],
115    "servicemailids": [ 1, 2 ],
116    "shortdescription": "Panda Dub, leading man of the french dub scene returns with a new show: Circle Live!",
117    "socialdistance": 50001,
118    "startts": "2014-09-26 15:24:36",
119    "subtitle": "With live band",
120    "subtitle2": "Exclusive concert",
121    "tags": [
122        "event tag1",
123        "event tag2"
124    ],
125    "ticketfeeid": 125,
126    "ticketinfoid": 125,
127    "ticketlayoutid": 125,
128    "totalmaxtickets": 1000,
129    "translations": {
130        "nameen": "English name",
131        "namefr": "Nom francais"
132    },
133    "upsellid": 125,
134    "waitinglisttype": 29001,
135    "webremark": "Age will be checked at the entrance"
136}

Response

  1HTTP/1.1 200 OK
  2Content-Type: application/json
  3
  4{
  5    "id": 1269434,
  6    "name": "Bonobo Live",
  7    "audiopreviewurl": "https://s3-eu-west-1.amazonaws.com/filestore-ticketmatic-com/test/9876/events/1234/image.jpg",
  8    "availability": [
  9        {
 10            "complimentary": 0,
 11            "free": 815,
 12            "locked_hard": 10,
 13            "locked_soft": 15,
 14            "reserved": 0,
 15            "sold_paid": 0,
 16            "sold_unpaid": 0,
 17            "tickettypeid": 89,
 18            "total": 840,
 19            "lastupdatets": "2015-05-29 09:21:10.38252"
 20        }
 21    ],
 22    "code": "864056970700",
 23    "contingents": [
 24        {
 25            "id": 98,
 26            "name": "Tickets",
 27            "amount": 100,
 28            "eventid": 777701,
 29            "eventspecificprices": null,
 30            "locks": [],
 31            "pricelistid": 6,
 32            "withimportedbarcodes": false
 33        }
 34    ],
 35    "currentstatus": 19001,
 36    "description": "Panda Dub, leading man of the french dub scene returns with a new show: Circle Live!",
 37    "endts": "2014-09-26 15:24:36",
 38    "externalcode": "56975647832",
 39    "image": "https://s3-eu-west-1.amazonaws.com/filestore-ticketmatic-com/test/9876/events/1234/image.jpg",
 40    "info": "Lockers available in the basement.",
 41    "layout": {
 42        "color": "#112233",
 43        "maxImage": true
 44    },
 45    "locationid": 125,
 46    "locationname": "Concert hall",
 47    "maxnbrofticketsperbasket": 5,
 48    "optinsetid": 125,
 49    "previews": [
 50        {
 51            "type": 30002,
 52            "url": "https://www.youtube.com/watch?v=RIGgn1s3AvI"
 53        },
 54        {
 55            "type": 30002,
 56            "url": "https://www.youtube.com/watch?v=6VrqR_GfvzE"
 57        },
 58        {
 59            "type": 30003,
 60            "url": "https://w.soundcloud.com/player/?url=https%3A//api.soundcloud.com/tracks/356544932&color=%23ff5500&auto_play=false&hide_related=false&show_comments=true&show_user=true&show_reposts=false&show_teaser=true&visual=true"
 61        }
 62    ],
 63    "prices": {
 64        "contingents": [
 65            {
 66                "contingentid": 1,
 67                "pricetypes": [
 68                    {
 69                        "pricetypeid": 2,
 70                        "saleschannels": [
 71                            {
 72                                "costs": [
 73                                    {
 74                                        "cost": 5.000000,
 75                                        "costid": 0
 76                                    }
 77                                ],
 78                                "price": 30.500000,
 79                                "saleschannelid": 3,
 80                                "servicecharge": 1.500000,
 81                                "tickettypepriceid": 4
 82                            }
 83                        ]
 84                    }
 85                ]
 86            }
 87        ]
 88    },
 89    "productionid": 1256975647,
 90    "publishedts": "2014-09-26 15:24:36",
 91    "queuetoken": 421,
 92    "revenuesplitid": 125,
 93    "saleendts": "2014-09-26 15:24:36",
 94    "saleschannels": [
 95        {
 96            "eventid": 123,
 97            "haswaitinglist": false,
 98            "isactive": true,
 99            "saleendts": "2014-09-26 15:24:36",
100            "saleschannelid": 1,
101            "salestartts": null
102        }
103    ],
104    "salestartts": "2014-09-26 15:24:36",
105    "salestatusmessagesid": 125,
106    "schedule": "20:00 support act
10721:00 show
10822:30 end",
109    "seatallowsingle": false,
110    "seated_chartkey": "",
111    "seated_contingents": [
112        {
113            "id": 98,
114            "name": "Tickets",
115            "amount": 100,
116            "eventid": 777701,
117            "eventspecificprices": null,
118            "locks": [],
119            "pricelistid": 6,
120            "withimportedbarcodes": false
121        }
122    ],
123    "seatingplancontingents": [
124        {
125            "id": 99,
126            "name": "Name A",
127            "amount": 50,
128            "eventid": 777702,
129            "seatrankid": 1
130        },
131        {
132            "id": 100,
133            "name": "Name B",
134            "amount": 50,
135            "eventid": 777702,
136            "seatrankid": 2
137        }
138    ],
139    "seatingplaneventspecificprices": {
140        "prices": [
141            {
142                "availabilities": [
143                    true
144                ],
145                "position": 3,
146                "prices": [ 25.000000 ],
147                "pricetypeid": 1,
148                "saleschannels": [ 1, 2 ]
149            },
150            {
151                "availabilities": [
152                    true
153                ],
154                "conditions": [
155                    {
156                        "type": "promocode",
157                        "value": "UGENT2013"
158                    }
159                ],
160                "position": 7,
161                "prices": [ 30.000000 ],
162                "pricetypeid": 2,
163                "saleschannels": [ 1, 2 ]
164            }
165        ],
166        "seatrankids": null
167    },
168    "seatingplanid": 125,
169    "seatingplanpricelistid": 125,
170    "seatselection": false,
171    "segmentationtags": [
172        "tag1",
173        "tag2"
174    ],
175    "servicemailids": [ 1, 2 ],
176    "shortdescription": "Panda Dub, leading man of the french dub scene returns with a new show: Circle Live!",
177    "socialdistance": 50001,
178    "startts": "2014-09-26 15:24:36",
179    "subtitle": "With live band",
180    "subtitle2": "Exclusive concert",
181    "tags": [
182        "event tag1",
183        "event tag2"
184    ],
185    "ticketfeeid": 125,
186    "ticketinfoid": 125,
187    "ticketlayoutid": 125,
188    "totalmaxtickets": 1000,
189    "translations": {
190        "nameen": "English name",
191        "namefr": "Nom francais"
192    },
193    "upsellid": 125,
194    "waitinglisttype": 29001,
195    "webremark": "Age will be checked at the entrance",
196    "createdts": "2014-09-26 15:24:36",
197    "lastupdatets": "2014-09-26 15:24:36"
198}

Request body fields

FieldDescription
name
mlstring 
(required)

Event name

Example value:"Bonobo Live"
audiopreviewurl
string

The audio preview url for the event

Example value:"https://s3-eu-west-1.amazonaws.com/filestore-ticketmatic-com/test/9876/events/1234/image.jpg"
contingents

Information about the contingents in the Event that are not in the seatingplan

Example value:[ { "id": 98, "name": "Tickets", "amount": 100, "eventid": 777701, "eventspecificprices": null, "locks": [], "pricelistid": 6, "withimportedbarcodes": false } ]
currentstatus
int

Event status

The available values for this field can be found on the Event page.

Example value:19001
description

Description of the event, visible for ticket buyers

Example value:"Panda Dub, leading man of the french dub scene returns with a new show: Circle Live!"
endts
timestamp 
(required)

Event end time

Example value:"2014-09-26 15:24:36"
externalcode
string

External event code.

This field is typically set when importing data from other systems.

Example value:"56975647832"
info

Practical info for the event, visible for ticket buyers

Example value:"Lockers available in the basement."
layout

Layout parameters for the event

Example value:{ "color": "#112233", "maxImage": true }
locationid
int

Event location ID

See event locations for more information.

Example value:125
maxnbrofticketsperbasket
int

Maximum number of tickets for this event that can be added to a basket

Example value:5
optinsetid
int

Opt-in set id

Example value:125
previews

Preview urls for the event.

Example value:[ { "type": 30002, "url": "https://www.youtube.com/watch?v=RIGgn1s3AvI" }, { "type": 30002, "url": "https://www.youtube.com/watch?v=6VrqR_GfvzE" }, { "type": 30003, "url": "https://w.soundcloud.com/player/?url=https%3A//api.soundcloud.com/tracks/356544932&color=%23ff5500&auto_play=false&hide_related=false&show_comments=true&show_user=true&show_reposts=false&show_teaser=true&visual=true" } ]
productionid
int

Production ID

Example value:1256975647
queuetoken
int

Queue ID

Example value:421
revenuesplitid
int

DEPRECATED

Example value:125
saleendts
timestamp

Time of end of sales.

Used for all sales channels for which no specific sales period has been defined.

Example value:"2014-09-26 15:24:36"
saleschannels

Per-sales channel information about when this event is for sale.

Example value:[ { "eventid": 123, "haswaitinglist": false, "isactive": true, "saleendts": "2014-09-26 15:24:36", "saleschannelid": 1, "salestartts": null } ]
salestartts
timestamp

Time of start of sales.

Used for all sales channels for which no specific sales period has been defined.

Example value:"2014-09-26 15:24:36"
salestatusmessagesid
int

Salestatus messages id

Example value:125
schedule

Schedule for the event, visible for ticket buyers

Example value:"20:00 support act 21:00 show 22:30 end"
seatallowsingle
bool

Allow or disallow leaving single seats on their own.

        </td>
    </tr><tr>
        <td class="field">
            <div class="name">seated_chartkey</div>
            <div class="type">string&nbsp;<div class="required">(required)</div></div>
        </td>
        <td class="description">
            
            
        </td>
    </tr><tr>
        <td class="field">
            <div class="name">seated_contingents</div>
            <div class="type"><a href="api/types/EventContingent">EventContingent</a><span class="code">[]</span></div>
        </td>
        <td class="description">
            <p>Seated contingents</p> 
            <strong>Example value:</strong><code>[ { &#34;id&#34;: 98, &#34;name&#34;: &#34;Tickets&#34;, &#34;amount&#34;: 100, &#34;eventid&#34;: 777701, &#34;eventspecificprices&#34;: null, &#34;locks&#34;: [], &#34;pricelistid&#34;: 6, &#34;withimportedbarcodes&#34;: false } ]</code>
        </td>
    </tr><tr>
        <td class="field">
            <div class="name">seatingplaneventspecificprices</div>
            <div class="type"><a href="api/types/PricelistPrices">PricelistPrices</a></div>
        </td>
        <td class="description">
            <p>Event specific prices in addition to the prices defined in the field <code>seatingplanpricelistid</code>. Prices from the pricelist and the event specific prices are combined in one pricelist for the event. The optional position attribute defines where the event specific prices will be positioned in the resulting pricelist</p> 
            <strong>Example value:</strong><code>{ &#34;prices&#34;: [ { &#34;availabilities&#34;: [ true ], &#34;position&#34;: 3, &#34;prices&#34;: [ 25.000000 ], &#34;pricetypeid&#34;: 1, &#34;saleschannels&#34;: [ 1, 2 ] }, { &#34;availabilities&#34;: [ true ], &#34;conditions&#34;: [ { &#34;type&#34;: &#34;promocode&#34;, &#34;value&#34;: &#34;UGENT2013&#34; } ], &#34;position&#34;: 7, &#34;prices&#34;: [ 30.000000 ], &#34;pricetypeid&#34;: 2, &#34;saleschannels&#34;: [ 1, 2 ] } ], &#34;seatrankids&#34;: null }</code>
        </td>
    </tr><tr>
        <td class="field">
            <div class="name">seatingplanid</div>
            <div class="type">int</div>
        </td>
        <td class="description">
            <p>Seating plan ID</p>  <p>Only set for events with fixed seats.</p> 
            <strong>Example value:</strong><code>125</code>
        </td>
    </tr><tr>
        <td class="field">
            <div class="name">seatingplanlocktemplate</div>
            <div class="type">string</div>
        </td>
        <td class="description">
            <p>Name of the seatingplanlocktemplate to apply linking a seatingplanid to this event. This is not a numeric id but the name of the lock template as specified in the seatingplan&rsquo;s logicalplan.</p> 
            <strong>Example value:</strong><code>&#34;Default&#34;</code>
        </td>
    </tr><tr>
        <td class="field">
            <div class="name">seatingplanpricelistid</div>
            <div class="type">int</div>
        </td>
        <td class="description">
            <p>Price list ID for fixed seats.</p>  <p>Only set for events with fixed seats. See <a href="api/settings/pricing/pricelists">price lists</a> for more information.</p> 
            <strong>Example value:</strong><code>125</code>
        </td>
    </tr><tr>
        <td class="field">
            <div class="name">seatselection</div>
            <div class="type">bool</div>
        </td>
        <td class="description">
            <p>Enable or disable seat selection for customers.</p> 
            
        </td>
    </tr><tr>
        <td class="field">
            <div class="name">segmentationtags</div>
            <div class="type">string<span class="code">[]</span></div>
        </td>
        <td class="description">
            <p>Segmentation tags</p> 
            <strong>Example value:</strong><code>[ &#34;tag1&#34;, &#34;tag2&#34; ]</code>
        </td>
    </tr><tr>
        <td class="field">
            <div class="name">servicemailids</div>
            <div class="type">int<span class="code">[]</span></div>
        </td>
        <td class="description">
            <p>servicemailids</p> 
            <strong>Example value:</strong><code>[ 1, 2 ]</code>
        </td>
    </tr><tr>
        <td class="field">
            <div class="name">shortdescription</div>
            <div class="type"><a href="api/coreconcepts/translations">mlstring</a></div>
        </td>
        <td class="description">
            <p>Short description of the event, visible for ticket buyers</p> 
            <strong>Example value:</strong><code>&#34;Panda Dub, leading man of the french dub scene returns with a new show: Circle Live!&#34;</code>
        </td>
    </tr><tr>
        <td class="field">
            <div class="name">socialdistance</div>
            <div class="type">int</div>
        </td>
        <td class="description">
            <p>Social distance type. Determines if social distance must be practiced.</p> 
            <strong>Example value:</strong><code>50001</code>
        </td>
    </tr><tr>
        <td class="field">
            <div class="name">startts</div>
            <div class="type">timestamp&nbsp;<div class="required">(required)</div></div>
        </td>
        <td class="description">
            <p>Event start time</p> 
            <strong>Example value:</strong><code>&#34;2014-09-26 15:24:36&#34;</code>
        </td>
    </tr><tr>
        <td class="field">
            <div class="name">subtitle</div>
            <div class="type"><a href="api/coreconcepts/translations">mlstring</a></div>
        </td>
        <td class="description">
            <p>Event subtitle</p> 
            <strong>Example value:</strong><code>&#34;With live band&#34;</code>
        </td>
    </tr><tr>
        <td class="field">
            <div class="name">subtitle2</div>
            <div class="type"><a href="api/coreconcepts/translations">mlstring</a></div>
        </td>
        <td class="description">
            <p>Event subtitle (2)</p> 
            <strong>Example value:</strong><code>&#34;Exclusive concert&#34;</code>
        </td>
    </tr><tr>
        <td class="field">
            <div class="name">tags</div>
            <div class="type">string<span class="code">[]</span></div>
        </td>
        <td class="description">
            <p>Event tags</p> 
            <strong>Example value:</strong><code>[ &#34;event tag1&#34;, &#34;event tag2&#34; ]</code>
        </td>
    </tr><tr>
        <td class="field">
            <div class="name">ticketfeeid</div>
            <div class="type">int</div>
        </td>
        <td class="description">
            <p>Ticket fee ID</p>  <p>Determines which ticket fee rules are used for this event. See <a href="api/settings/pricing/ticketfees">ticket fees</a> for more information.</p> 
            <strong>Example value:</strong><code>125</code>
        </td>
    </tr><tr>
        <td class="field">
            <div class="name">ticketinfoid</div>
            <div class="type">int</div>
        </td>
        <td class="description">
            <p>Ticketinfo id</p> 
            <strong>Example value:</strong><code>125</code>
        </td>
    </tr><tr>
        <td class="field">
            <div class="name">ticketlayoutid</div>
            <div class="type">int</div>
        </td>
        <td class="description">
            <p>Ticket layout ID</p>  <p>See <a href="api/settings/communicationanddesign/ticketlayouts">ticket layouts</a> for more information.</p> 
            <strong>Example value:</strong><code>125</code>
        </td>
    </tr><tr>
        <td class="field">
            <div class="name">totalmaxtickets</div>
            <div class="type">int</div>
        </td>
        <td class="description">
            <p>Determines the total maximum amount of tickets that can be sold for event.</p> 
            <strong>Example value:</strong><code>1000</code>
        </td>
    </tr><tr>
        <td class="field">
            <div class="name">translations</div>
            <div class="type">map&lt;string, string&gt;</div>
        </td>
        <td class="description">
            <p>Translation of event fields</p> 
            <strong>Example value:</strong><code>{ &#34;nameen&#34;: &#34;English name&#34;, &#34;namefr&#34;: &#34;Nom francais&#34; }</code>
        </td>
    </tr><tr>
        <td class="field">
            <div class="name">upsellid</div>
            <div class="type">int</div>
        </td>
        <td class="description">
            <p>Upsell id</p> 
            <strong>Example value:</strong><code>125</code>
        </td>
    </tr><tr>
        <td class="field">
            <div class="name">waitinglisttype</div>
            <div class="type">int</div>
        </td>
        <td class="description">
            <p>The type of the waiting list the event uses</p> 
            <strong>Example value:</strong><code>29001</code>
        </td>
    </tr><tr>
        <td class="field">
            <div class="name">webremark</div>
            <div class="type"><a href="api/coreconcepts/translations">mlstring</a></div>
        </td>
        <td class="description">
            <p>Small description that will be shown on the sales pages of this event</p> 
            <strong>Example value:</strong><code>&#34;Age will be checked at the entrance&#34;</code>
        </td>
    </tr>
</tbody>

Type reference: Event

Result fields

FieldDescription
id
int

Event ID

Example value:1269434
name

Event name

Example value:"Bonobo Live"
audiopreviewurl
string

The audio preview url for the event

Example value:"https://s3-eu-west-1.amazonaws.com/filestore-ticketmatic-com/test/9876/events/1234/image.jpg"
availability

Information on the availability of tickets per contingent. Read-only.

Example value:[ { "complimentary": 0, "free": 815, "locked_hard": 10, "locked_soft": 15, "reserved": 0, "sold_paid": 0, "sold_unpaid": 0, "tickettypeid": 89, "total": 840, "lastupdatets": "2015-05-29 09:21:10.38252" } ]
code
string

Event code.

Used as a unique identifier in web sales.

Example value:"864056970700"
contingents

Information about the contingents in the Event that are not in the seatingplan

Example value:[ { "id": 98, "name": "Tickets", "amount": 100, "eventid": 777701, "eventspecificprices": null, "locks": [], "pricelistid": 6, "withimportedbarcodes": false } ]
currentstatus
int

Event status

The available values for this field can be found on the Event page.

Example value:19001
description

Description of the event, visible for ticket buyers

Example value:"Panda Dub, leading man of the french dub scene returns with a new show: Circle Live!"
endts
timestamp

Event end time

Example value:"2014-09-26 15:24:36"
externalcode
string

External event code.

This field is typically set when importing data from other systems.

Example value:"56975647832"
image
string

The image url for the event display image

Example value:"https://s3-eu-west-1.amazonaws.com/filestore-ticketmatic-com/test/9876/events/1234/image.jpg"
info

Practical info for the event, visible for ticket buyers

Example value:"Lockers available in the basement."
layout

Layout parameters for the event

Example value:{ "color": "#112233", "maxImage": true }
locationid
int

Event location ID

See event locations for more information.

Example value:125
locationname
string

Event location name

Automatically derived using locationid.

Example value:"Concert hall"
maxnbrofticketsperbasket
int

Maximum number of tickets for this event that can be added to a basket

Example value:5
optinsetid
int

Opt-in set id

Example value:125
previews

Preview urls for the event.

Example value:[ { "type": 30002, "url": "https://www.youtube.com/watch?v=RIGgn1s3AvI" }, { "type": 30002, "url": "https://www.youtube.com/watch?v=6VrqR_GfvzE" }, { "type": 30003, "url": "https://w.soundcloud.com/player/?url=https%3A//api.soundcloud.com/tracks/356544932&color=%23ff5500&auto_play=false&hide_related=false&show_comments=true&show_user=true&show_reposts=false&show_teaser=true&visual=true" } ]
prices

Information on the available prices for the event

Example value:{ "contingents": [ { "contingentid": 1, "pricetypes": [ { "pricetypeid": 2, "saleschannels": [ { "costs": [ { "cost": 5.000000, "costid": 0 } ], "price": 30.500000, "saleschannelid": 3, "servicecharge": 1.500000, "tickettypepriceid": 4 } ] } ] } ] }
productionid
int

Production ID

Example value:1256975647
publishedts
timestamp

Event publish time

Example value:"2014-09-26 15:24:36"
queuetoken
int

Queue ID

Example value:421
revenuesplitid
int

DEPRECATED

Example value:125
saleendts
timestamp

Time of end of sales.

Used for all sales channels for which no specific sales period has been defined.

Example value:"2014-09-26 15:24:36"
saleschannels

Per-sales channel information about when this event is for sale.

Example value:[ { "eventid": 123, "haswaitinglist": false, "isactive": true, "saleendts": "2014-09-26 15:24:36", "saleschannelid": 1, "salestartts": null } ]
salestartts
timestamp

Time of start of sales.

Used for all sales channels for which no specific sales period has been defined.

Example value:"2014-09-26 15:24:36"
salestatusmessagesid
int

Salestatus messages id

Example value:125
schedule

Schedule for the event, visible for ticket buyers

Example value:"20:00 support act 21:00 show 22:30 end"
seatallowsingle
bool

Allow or disallow leaving single seats on their own.

seated_chartkey
string
seated_contingents

Seated contingents

Example value:[ { "id": 98, "name": "Tickets", "amount": 100, "eventid": 777701, "eventspecificprices": null, "locks": [], "pricelistid": 6, "withimportedbarcodes": false } ]
seatingplancontingents

Information about the contingents defined in the seatingplan. Read-only.

Example value:[ { "id": 99, "name": "Name A", "amount": 50, "eventid": 777702, "seatrankid": 1 }, { "id": 100, "name": "Name B", "amount": 50, "eventid": 777702, "seatrankid": 2 } ]
seatingplaneventspecificprices

Event specific prices in addition to the prices defined in the field seatingplanpricelistid. Prices from the pricelist and the event specific prices are combined in one pricelist for the event. The optional position attribute defines where the event specific prices will be positioned in the resulting pricelist

Example value:{ "prices": [ { "availabilities": [ true ], "position": 3, "prices": [ 25.000000 ], "pricetypeid": 1, "saleschannels": [ 1, 2 ] }, { "availabilities": [ true ], "conditions": [ { "type": "promocode", "value": "UGENT2013" } ], "position": 7, "prices": [ 30.000000 ], "pricetypeid": 2, "saleschannels": [ 1, 2 ] } ], "seatrankids": null }
seatingplanid
int

Seating plan ID

Only set for events with fixed seats.

Example value:125
seatingplanpricelistid
int

Price list ID for fixed seats.

Only set for events with fixed seats. See price lists for more information.

Example value:125
seatselection
bool

Enable or disable seat selection for customers.

segmentationtags
string[]

Segmentation tags

Example value:[ "tag1", "tag2" ]
servicemailids
int[]

servicemailids

Example value:[ 1, 2 ]
shortdescription

Short description of the event, visible for ticket buyers

Example value:"Panda Dub, leading man of the french dub scene returns with a new show: Circle Live!"
socialdistance
int

Social distance type. Determines if social distance must be practiced.

Example value:50001
startts
timestamp

Event start time

Example value:"2014-09-26 15:24:36"
subtitle

Event subtitle

Example value:"With live band"
subtitle2

Event subtitle (2)

Example value:"Exclusive concert"
tags
string[]

Event tags

Example value:[ "event tag1", "event tag2" ]
ticketfeeid
int

Ticket fee ID

Determines which ticket fee rules are used for this event. See ticket fees for more information.

Example value:125
ticketinfoid
int

Ticketinfo id

Example value:125
ticketlayoutid
int

Ticket layout ID

See ticket layouts for more information.

Example value:125
totalmaxtickets
int

Determines the total maximum amount of tickets that can be sold for event.

Example value:1000
translations
map<string, string>

Translation of event fields

Example value:{ "nameen": "English name", "namefr": "Nom francais" }
upsellid
int

Upsell id

Example value:125
waitinglisttype
int

The type of the waiting list the event uses

Example value:29001
webremark

Small description that will be shown on the sales pages of this event

Example value:"Age will be checked at the entrance"
createdts
timestamp

Created timestamp

Example value:"2014-09-26 15:24:36"
lastupdatets
timestamp

Last updated timestamp

Example value:"2014-09-26 15:24:36"

Type reference: Event