API – ticket offices

Information about ticket offices.

• Endpoint: GET https://www.zditm.szczecin.pl/api/v2/ticket-offices?format=json|cbor
• Data type: application/json (default) or application/cbor (when format=cbor)
• Update frequency: as required

Data structure

{
  "data": [
    {
      "id": 26,
      "name": "C.H. Turzyn",
      "type": {
        "symbol": "POK",
        "name": {
          "pl": "Punkt Obsługi Klientów",
          "en": "Passenger Service Point",
          "de": "Kundenberatungsstelle",
          "uk": "Пункт обслуговування клієнтів"
        }
      },
      "address": "najbliższe wejście od ul. 26 Kwietnia",
      "phone": "695690715",
      "note": null,
      "latitude": 53.427471,
      "longitude": 14.53099,
      "monday": {
        "opening_hours": "9:00–19:00",
        "note": null
      },
      "tuesday": {
        "opening_hours": "9:00–19:00",
        "note": null
      },
      "wednesday": {
        "opening_hours": "9:00–19:00",
        "note": null
      },
      "thursday": {
        "opening_hours": "9:00–19:00",
        "note": null
      },
      "friday": {
        "opening_hours": "9:00–19:00",
        "note": null
      },
      "saturday": {
        "opening_hours": "9:00–19:00",
        "note": null
      },
      "sunday": {
        "opening_hours": "10:00–16:00",
        "note": {
          "pl": "tylko niedziele handlowe",
          "en": "only on Sunday trading days",
          "de": "nur verkaufsoffene Sonntage",
          "uk": "тільки по робочих неділях"
        }
      },
      "updated_at": "2023-07-14T16:00:27.000000Z"
    },

    ...

  ]
}

• int id – ticket office identifier
• string name – name of the ticket office
• object type – object containing information about the ticket office type
  • string symbol – ticket office type symbol
  • object name – object containing the ticket office type name
    • string pl – ticket office type name in Polish
    • string en – ticket office type name in English
    • string de – ticket office type name in German
    • string uk – ticket office type name in Ukrainian
• string|null address – ticket office address
• string|null phone – ticket office phone number
• object|null note – object containing additional information (null if all child fields return null)
  • string|null pl – additional information in Polish
  • string|null en – additional information in English
  • string|null de – additional information in German
  • string|null uk – additional information in Ukrainian
• float latitude – geographic coordinates of the ticket office (latitude)
• float longitude – geographic coordinates of the ticket office (longitude)
• object monday, object tuesday, object wednesday, object thursday, object friday, object saturday, object sunday – objects containing ticket office opening hours for each day of the week (Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday)
  • string|null opening_hours – ticket office opening hours
  • object|null note – object containing additional information (null if all child fields return null)
    • string|null pl – additional information in Polish
    • string|null en – additional information in English
    • string|null de – additional information in German
    • string|null uk – additional information in Ukrainian
• 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.

Migration from version 1

1. Endpoint changed to: GET https://www.zditm.szczecin.pl/api/v2/ticket-offices.
2. The type_symbol, type_name_pl, type_name_en, type_name_de, and type_name_uk fields have been moved to the new type object.
3. The notes_pl, notes_en, notes_de, and notes_uk fields have been moved to the new note object.
4. The notes_pl, notes_en, notes_de, and notes_uk fields within the monday, tuesday, wednesday, thursday, friday, saturday, and sunday objects have been moved to the new note object.
5. CBOR format (application/cbor) is additionally supported via the format=cbor parameter.