---
title: "This operation provides the master data for german railway stations."
method: GET
path: "/stations"
---

# This operation provides the master data for german railway stations.

`GET /stations`

Get a QueryResult object containing station objects from the database applying to the parameters described below.

QueryResult is a container providing the following information about the query result.
  1. the total number of hits
  2. the maximum number of hits to be returned in that QueryResult object
  3. the offset of the first hit returned in that QueryResult object with respect to all hits returned by the query
  4. the result objects

The parameters described below work as filters to reduce the number of hits returned. Some of these parameters must be used only once, others are allowed to be used multiple times. Valid parameters that are allowed to be used only once are _offset_, _limit_ and _logicaloperator_.

All other parameters described below may be used multiple times.

If a parameter is given more than once, the result will contain all hits that match all given parameter values.

E.g. _federalstate=berlin&federalstate=saarland_ returns all stations in Berlin and Saarland.

If more than one filter criterion is used at the same time, the different filter criteria are interpreted as if they are combined by a logical AND operator, unless the parameter _logicaloperator_ is set to _or_.

E.g. _category=1-2&federalstate=hamburg_ returns all stations in Hamburg having category 1 or 2.

_category=1-2&federalstate=hamburg&federalsate=hessen_ returns all stations in Hamburg and Hessen having category 1 or 2, while

_searchstring=berlin*&federalstate=hamburg&federalsate=hessen&logicaloperator=or_ will return all stations with a name starting with 'berlin' as well as all stations in Hamburg and Hessen.

If no 'limit' parameter is given, the number of hits (stations) is set to its maximum value of 10000.

To specify parameter values containing German umlauts, the following encoding has to be used
  * ä  => %C3%A4
  * ö  => %C3%B6
  * ü  => %C3%BC
  * Ä  => %C3%84
  * Ö  => %C3%96
  * Ü  => %C3%9C
  * ß  => %C3%9F

## Query parameters

- `offset` integer
- `limit` integer
- `searchstring` string
- `category` string
- `federalstate` string
- `eva` integer
- `ril` string
- `logicaloperator` string

## Response `200`

station data

- StationQuery
  - `limit` integer — maximum number of result objects to be returned
  - `offset` integer — offset of the first result object with respect to the total number of hits produced by the query
  - `result` Station[] — result objects produced by that query
    - `DBinformation` Schedule — a weekly schedule
      - `availability` object
        - `friday` OpeningHours — period of time from/to
          - `fromTime` string
          - `toTime` string
        - `holiday` OpeningHours — period of time from/to
          - `fromTime` string
          - `toTime` string
        - `monday` OpeningHours — period of time from/to
          - `fromTime` string
          - `toTime` string
        - `saturday` OpeningHours — period of time from/to
          - `fromTime` string
          - `toTime` string
        - `sunday` OpeningHours — period of time from/to
          - `fromTime` string
          - `toTime` string
        - `thursday` OpeningHours — period of time from/to
          - `fromTime` string
          - `toTime` string
        - `tuesday` OpeningHours — period of time from/to
          - `fromTime` string
          - `toTime` string
        - `wednesday` OpeningHours — period of time from/to
          - `fromTime` string
          - `toTime` string
    - `aufgabentraeger` Aufgabentraeger — local public sector entity, responsible for short distance public transport in a specific area
      - `name` string — full name of Aufgabentraeger
      - `shortName` string — unique identifier
    - `category` integer — the stations category (-1...7). Stations with category -1 or 0 are not in production, e.g. planned, saled, without train stops.
    - `evaNumbers` EVANumber[] — station related EVA-Numbers
      - `geographicCoordinates` GeographicPoint — GEOJSON object of type point. By default WGS84 is the coordinate system in GEOJSON.
        - `coordinates` number[] — first value is longitude, second latitude, third altitude (currently not provided)
        - `type` string — the type of the GEOJSON Object e.g. point. Currently only point coordinates without altitude are provided.
      - `isMain` boolean — isMain is supported for compatibility reasons only. The attribute has no business background in terms of DB InfraGo AG.
      - `number` integer — EVA identifier
    - `federalState` string — german federal state
    - `hasBicycleParking` boolean — public bicycle parking y/n
    - `hasCarRental` boolean — car sharing or car rental y/n
    - `hasDBLounge` boolean — DB lounge y/n
    - `hasLocalPublicTransport` boolean — local public transport y/n
    - `hasLockerSystem` boolean — public facilities y/n
    - `hasLostAndFound` boolean — lost and found y/n
    - `hasMobilityService` string — values are 'no' OR 'Nur nach Voranmeldung unter 030 65 21 28 88 (Ortstarif)' OR 'Ja, um Voranmeldung unter 030 65 21 28 88 (Ortstarif) wird gebeten'
    - `hasParking` boolean — public parking y/n
    - `hasPublicFacilities` boolean — public facilities y/n
    - `hasRailwayMission` boolean — railway mission y/n
    - `hasSteplessAccess` 'yes' | 'no' | 'partial'
    - `hasTaxiRank` boolean — taxi rank in front of the station y/n
    - `hasTravelCenter` boolean — local travel center y/n
    - `hasTravelNecessities` boolean — a shop for travel necessities y/n
    - `hasWiFi` boolean — public Wi-Fi is available y/n
    - `ifopt` string — the stations IFOPT number
    - `localServiceStaff` Schedule — a weekly schedule
      - `availability` object
        - `friday` OpeningHours — period of time from/to
          - `fromTime` string
          - `toTime` string
        - `holiday` OpeningHours — period of time from/to
          - `fromTime` string
          - `toTime` string
        - `monday` OpeningHours — period of time from/to
          - `fromTime` string
          - `toTime` string
        - `saturday` OpeningHours — period of time from/to
          - `fromTime` string
          - `toTime` string
        - `sunday` OpeningHours — period of time from/to
          - `fromTime` string
          - `toTime` string
        - `thursday` OpeningHours — period of time from/to
          - `fromTime` string
          - `toTime` string
        - `tuesday` OpeningHours — period of time from/to
          - `fromTime` string
          - `toTime` string
        - `wednesday` OpeningHours — period of time from/to
          - `fromTime` string
          - `toTime` string
    - `mailingAddress` Address
      - `city` string
      - `houseNumber` string
      - `street` string
      - `zipcode` string
    - `mobilityServiceStaff` MobilityServiceStaff
      - `availability` DoubleSchedule — a weekly schedule with 2 ranges
        - `availability` object
          - `friday1` OpeningHours — period of time from/to
            - `fromTime` string
            - `toTime` string
          - `friday2` OpeningHours — period of time from/to
            - `fromTime` string
            - `toTime` string
          - `monday1` OpeningHours — period of time from/to
            - `fromTime` string
            - `toTime` string
          - `monday2` OpeningHours — period of time from/to
            - `fromTime` string
            - `toTime` string
          - `saturday1` OpeningHours — period of time from/to
            - `fromTime` string
            - `toTime` string
          - `saturday2` OpeningHours — period of time from/to
            - `fromTime` string
            - `toTime` string
          - `sunday1` OpeningHours — period of time from/to
            - `fromTime` string
            - `toTime` string
          - `sunday2` OpeningHours — period of time from/to
            - `fromTime` string
            - `toTime` string
          - `thursday1` OpeningHours — period of time from/to
            - `fromTime` string
            - `toTime` string
          - `thursday2` OpeningHours — period of time from/to
            - `fromTime` string
            - `toTime` string
          - `tuesday1` OpeningHours — period of time from/to
            - `fromTime` string
            - `toTime` string
          - `tuesday2` OpeningHours — period of time from/to
            - `fromTime` string
            - `toTime` string
          - `wednesday1` OpeningHours — period of time from/to
            - `fromTime` string
            - `toTime` string
          - `wednesday2` OpeningHours — period of time from/to
            - `fromTime` string
            - `toTime` string
      - `staffOnSite` boolean — staff is on site
    - `name` string — the stations name
    - `number` integer — unique identifier representing a specific railway station
    - `priceCategory` integer — determines in some respect the price for train stops at a specific station (1..7)
    - `regionalbereich` RegionalBereich — reference object. an internal organization type of DB InfraGo AG, regional department.
      - `name` string — name of the regional department
      - `number` integer — unique identifier of the regional department
      - `shortName` string
    - `ril100Identifiers` RiL100Identifier[] — station related Ril100s
      - `geographicCoordinates` GeographicPoint — GEOJSON object of type point. By default WGS84 is the coordinate system in GEOJSON.
        - `coordinates` number[] — first value is longitude, second latitude, third altitude (currently not provided)
        - `type` string — the type of the GEOJSON Object e.g. point. Currently only point coordinates without altitude are provided.
      - `hasSteamPermission` boolean — permission for steam engines y/n
      - `isMain` boolean — is stations main Ril100. Determination of DB InfraGo AG
      - `primaryLocationCode` string — UIC Primary Location Code PLC
      - `rilIdentifier` string — Unique identifier of 'Betriebsstelle' according to Ril100
      - `steamPermission` 'restricted' | 'unrestricted' | 'entryBan' — Indicates whether the entry for a steam engine is restricted (eingeschränkt), unrestricted (uneingeschränkt) or has an entryBan (Einfahrverbot).
    - `stationManagement` StationManagement
      - `name` string
      - `number` integer — identifier
    - `szentrale` SZentrale — 3-S-Zentralen are 7/24 hours operating centers for german railway stations
      - `address` Address
        - `city` string
        - `houseNumber` string
        - `street` string
        - `zipcode` string
      - `email` string — email adress of the 3-S-Zentrale (no longer supported!)
      - `internalFaxNumber` string — internal fax number
      - `internalPhoneNumber` string — internal phone number
      - `mobilePhoneNumber` string — mobile phone number (no longer supported!)
      - `name` string — unique identifier of 3SZentrale
      - `number` integer — unique identifier for SZentrale
      - `publicFaxNumber` string — public fax number
      - `publicPhoneNumber` string
    - `timeTableOffice` TimetableOffice
      - `email` string — email
      - `name` string — identifier
    - `wirelessLan` WirelessLan
      - `amount` integer — amount of access points
      - `installDate` string — installation date
      - `product` string — product
  - `total` integer — total number of hits produced by that query

## Other responses

- `400` — bad request (illegal parameter or illegal parameter value)
- `404` — not found
- `500` — internal server error

---

[API](https://skmtc.net/stainless-api/apis/stada-station-data.md) · [All operations](https://skmtc.net/stainless-api/apis/stada-station-data/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stainless-api/stada-station-data/versions/2a72886a1ec3/schema)
