API – timetable change descriptions

Information on recent and upcoming changes to timetables.

  • Endpoint: GET https://www.zditm.szczecin.pl/api/v1/timetable-change-descriptions
  • Data type: application/json
  • Update frequency: as required

Data structure

{
  "data": [
    {
      "id": 283,
      "valid_from": "2023-05-27T22:00:00.000000Z",
      "valid_to": null,
      "description": {
        "pl": "zmiana tras i rozkładów jazdy linii 806, 812, B, 522, 523, 525, 530, 532",
        "en": "change of the lines 806, 812, B, 522, 523, 525, 530, 532 routes and timetables",
        "de": "geänderte Strecken und Fahrpläne der Linien 806, 812, B, 522, 523, 525, 530, 532",
        "uk": "зміна схеми і розкладів руху маршрутів 806, 812, B, 522, 523, 525, 530, 532"
      },
      "updated_at": "2023-05-28T11:45:41.000000Z"
    },

    ...

  ]
}
  • int id – change description identifier
  • string valid_from – date and time from which the timetable changes take effect
  • string|null valid_to – date and time until which the changes apply (null if no end has been specified)
  • object description – object containing the change description in multiple languages
    • string pl – Polish description
    • string en – English description
    • string de – German description
    • string uk – Ukrainian description
  • string updated_at – timestamp of the last data update

General information

  1. The data are provided free of charge under the CC0 1.0 licence, for use in any context, with no prior notification required.
  2. Zarząd Dróg i Transportu Miejskiego w Szczecinie (Roads and Public Transport Authority in Szczecin) does not guarantee the accuracy or completeness of the data and accepts no liability for any loss or decisions made on the basis of this information.
  3. In any product using the data (application, website, publication, etc.), please cite the data source as Zarząd Dróg i Transportu Miejskiego w Szczecinie, or in abbreviated form, ZDiTM Szczecin; although not legally required, this is appreciated.
  4. Where possible, please include a link to this page or to the ZDiTM Szczecin homepage in any product using the data; this is also not a legal obligation.
  5. Clients should recognise and honour the HTTP headers Cache-Control and ETag.
  6. API requests are rate‑limited: 100 requests per minute per IP address across all endpoints. The X-RateLimit-Remaining header shows the number of remaining requests. Once the limit is reached, an HTTP 429 response is returned. The X-RateLimit-Reset header then contains a Unix timestamp for when the limit resets, and the Retry-After header shows the number of seconds until reset.
  7. If possible, please include in your User-Agent header information identifying the entity using the data (e.g. the name of your application, website, or its URL).
  8. In the event of excessive server load, ZDiTM Szczecin reserves the right to partially or fully block access to the API.