Public API

Public API

Organizer/Venue 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 )

Usage Guidelines

  • Recommended API usage window: 02:00–07:00 EET/EEST.​
  • User-Agent: Clients must provide a descriptive User-Agent header that identifies the application or data source.
  • Caching: Each resource may return data cached for up to 15 minutes. Therefore, requests for the same resource should be limited to one request per 15-minute interval.
  • Global rate limit: The total number of requests across all resources must not exceed 1 request per minute.

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