Public API

Public API

Organizer repertoire

The following Public API route is intended to retrieve organizer or venue repertoire,  please ensure you have fulfilled the required prerequisites before using this endpoint.

Prerequisites

  • Organizer unique identifier ( when retrieving by organizer )
  • Venue unique identifier ( when retrieving by venue )

Call ( by organizer )

GET https://www.bilesuparadize.lv/api/organizer/{your-organizer-unique-identifier}/repertoire

*Please replace {your-organizer-unique-identifier} with an actual value

Call ( by venue )

GET https://www.bilesuparadize.lv/api/venue/{your-venue-unique-identifier}/repertoire

*Please replace {your-venue-unique-identifier} with an actual value

Response

Please treat all response data types as is, unless footnote is specified with additional information about the data type.

For example:

  • "id": 12345 - treat it as a number
  • "id": 12345 //*.key seek information about the data type at the bottom of this section

JSON Array of events

  [
  {
    "id": 12345,
    "urls": {
      "lv": "https://www.bilesuparadize.lv/lv/event/12345",
      "en": "https://www.bilesuparadize.lv/en/event/12345",
      "ru": "https://www.bilesuparadize.lv/ru/event/12345" 
    },
    "dateTime": "YYYY-MM-DDThh:mm:ss", //*.dateTime
    "disclaimers": {
"lv": "Example disclaimer",
"en": "Example disclaimer",
"ru": "Example disclaimer"
},
"sales": { "start": "YYYY-MM-DDThh:mm:ss", //*.sales.start "end": "YYYY-MM-DDThh:mm:ss" //*.sales.end }, "descriptions": { "lv": "Example description", "en": "Example description", "ru": "Example description" }, "properties": { "intendedAge": { "lv": 16, "en": 16, "ru": 16 }, "duration": { "lv": "2h 30m", "en": "2h 30m", "ru": "2h 30m" }, "subtitles": { "lv": "Latviešu", "en": "Latvian", "ru": "Латышский" }, "language": { "lv": "Latviešu", "en": "Latvian", "ru": "Латышский" } }, "published": "YYYY-MM-DDThh:mm:ss", //*.published "organizer": { "id": 12, "name": "Example organizer", "urls": { "lv": "https://www.bilesuparadize.lv/lv/organizer/12", "en": "https://www.bilesuparadize.lv/en/organizer/12", "ru": "https://www.bilesuparadize.lv/ru/organizer/12" }, "registrationNumber": "123456789", "externalUrl": "http://example.com" //*.organizer.externalUrl }, "performance": { "id": 1234, "urls": { "lv": "https://www.bilesuparadize.lv/lv/performance/1234", "en": "https://www.bilesuparadize.lv/en/performance/1234", "ru": "https://www.bilesuparadize.lv/ru/performance/1234" }, "titles": { "lv": "Example performance", "ru": "Example performance", "en": "Example performance" }, "standardImageUrls": { //*.standardImageUrls "lv": "https://media.bilesuparadize.lv/lv/performance/1234/standard_lv.jpg", "ru": "https://media.bilesuparadize.lv/lv/performance/1234/standard_ru.jpg", "en": "https://media.bilesuparadize.lv/lv/performance/1234/standard_en.jpg" }, "posterImageUrls": {//*.posterImageUrls "lv": "https://media.bilesuparadize.lv/lv/performance/1234/poster_lv.jpg", "ru": "https://media.bilesuparadize.lv/lv/performance/1234/poster_ru.jpg", "en": "https://media.bilesuparadize.lv/lv/performance/1234/poster_en.jpg" }, "mobileImageUrls": {//*.mobileImageUrls "lv": "https://media.bilesuparadize.lv/lv/performance/1234/mobile_lv.jpg", "ru": "https://media.bilesuparadize.lv/lv/performance/1234/mobile_ru.jpg", "en": "https://media.bilesuparadize.lv/lv/performance/1234/mobile_en.jpg" }, "smallImageUrls": {//*.smallImageUrls "lv": "https://media.bilesuparadize.lv/lv/performance/1234/small_lv.jpg", "ru": "https://media.bilesuparadize.lv/lv/performance/1234/small_ru.jpg", "en": "https://media.bilesuparadize.lv/lv/performance/1234/small_en.jpg" }, "categories": [ {      lv: "Teātris", en: "Theatre", ru: "Театр" }, { lv: "Drāma", en: "Drama", ru: "Драма" } ] }, "hall": { "id": 321, "address": "Rīga, Duntes iela 3", "titles": { "lv": "Example hall", "ru": "Example hall", "en": "Example hall" } }, "venue": { "id": 21, "urls": { "lv": "https://www.bilesuparadize.lv/lv/location/21", "en": "https://www.bilesuparadize.lv/en/location/21", "ru": "https://www.bilesuparadize.lv/ru/location/21" }, "titles": { "lv": "Example venue", "ru": "Example venue", "en": "Example venue" }, "geo": { // *.venue.geo "lat": 90, //*.venue.geo.lat "long": 0 //*.venue.geo.long } }, "prices": [ { "price": 10, //*.prices.*.price "count": 0, "types": [ "seat", "entrance"] //*.prices.*.types } ] }, "standardImageUrls": { //*.standardImageUrls "lv": "https://media.bilesuparadize.lv/lv/event/12345/standard_lv.jpg", "ru": "https://media.bilesuparadize.lv/lv/event/12345/standard_ru.jpg", "en": "https://media.bilesuparadize.lv/lv/event/12345/standard_en.jpg" }, "posterImageUrls": {//*.posterImageUrls "lv": "https://media.bilesuparadize.lv/lv/event/12345/poster_lv.jpg", "ru": "https://media.bilesuparadize.lv/lv/event/12345/poster_ru.jpg", "en": "https://media.bilesuparadize.lv/lv/event/12345/poster_en.jpg" }, "mobileImageUrls": {//*.mobileImageUrls "lv": "https://media.bilesuparadize.lv/lv/event/12345/mobile_lv.jpg", "ru": "https://media.bilesuparadize.lv/lv/event/12345/mobile_ru.jpg", "en": "https://media.bilesuparadize.lv/lv/event/12345/mobile_en.jpg" }, "smallImageUrls": {//*.smallImageUrls "lv": "https://media.bilesuparadize.lv/lv/event/12345/small_lv.jpg", "ru": "https://media.bilesuparadize.lv/lv/event/12345/small_ru.jpg", "en": "https://media.bilesuparadize.lv/lv/event/12345/small_en.jpg" }, ... ]

*.dateTime, *.sales.start, *.sales.end, *published - string, date formatted in ISO 8601 format YYYY-MM-DDThh:mm:ss, for example 2020-12-31T23:59:59

*.organizer.externalUrl - string|null - If organizer url is not present this key will be null

*.venue.geo - Object|null, if venue has not specified latitude and/or longitute instead of object "geo" key will be null

*.venue.geo.lat, *.venue.geo.long, *.prices.*.price - number, should be treated as floating point

*.disclaimers, *.standardImageUrls, *.posterImageUrls,*.smallImageUrls, *.mobileImageUrls - Object|null. If either, lv, ru, en properties have string value, then key will be object. If all of the locales have null values then entire key will be null