Main navigation

Go to content

Documentation: station list

The webservice for the station list allows you to request the names of all of the stations. The express purpose of this service is that the users can cache the response for a limited time in order to realise auto-complete in a functional manner.


Request

There are two versions of the station list. As of May 2012, v2 is the recommended version. Version 1 will be phased out. Further information will be provided at a later date Request version 1 or version 2 of the station list here. No parameters apply.

Station list response version 1

The response (version 1) consists of the element 'stations', which contains an element 'station' for each station.

The element station is structured as follows:

  • name (1): Full name of the station, consisting of max. 25 characters.
  • code (1): Abbreviation for the station. This abbreviation is the station identification, but the same abbreviation may occur multiple times in the station list in the event of aliases. See 'Aliases' below.
  • country (1): Station country code.
  • lat (1): Station latitude coordinate.
  • long (1): Station longitude coordinate.
  • alias (1): Indicates whether this station is an alias for another station. This means that 1 physical station has more than 1 spelling for the station name. For example 's Hertogenbosch and Den Bosch, 's Gravenhage and Den Haag, Utrecht Maliebaan and Spoorwegmuseum.

Sample station list version 1

See the example below for part of the response (first 3 stations):

<stations>
  <station>
    <name>'s-Gravenhage</name>
    <code>GVC</code>
    <country>NL</country>
    <lat>52.080276</lat>
    <long>4.325</long>
    <alias>true</alias>
  </station>
  <station>
    <name>'s-Hertogenbosch</name>
    <code>HT</code>
    <country>NL</country>
    <lat>51.690556</lat>
    <long>5.293611</long>
    <alias>false</alias>
  </station>
  <station>
    <name>'s-Hertogenbosch Oost</name>
    <code>HTO</code>
    <country>NL</country>
    <lat>51.700554</lat>
    <long>5.318333</long>
    <alias>false</alias>
  </station>

Station list response version 2

The response (version 2) consists of the element 'stations' which contains an element 'station' for each station.

The stations are structured as follows:

  • Code (1): Station identification abbreviation.
  • Type (1): Station type.
  • Namen (1): Station names.
  • Land (1): Station country code:
  • UICCode (1): Station UIC code, identification code of the international railway union, Union Internationale des Chemins de fer.
  • Lat (1): Station latitude coordinate.
  • Lon (1): Station longitude coordinate.
  • Synoniemen (1): Synonyms for the station.

The element 'Namen' is structured as follows:

  • Kort (1): brief name of the station, consisting of max.10  characters.
  • Middel (1): Medium-length name of the station, consisting of max. 16 characters.
  • Lang (1): Full name of the station, consisting of max. 25 characters.

The element 'Synoniemen' is structured as follows:

  • Synoniem (0..n): Name used as a synonym for the full station name.

Sample station list version 2

See the example below for part of the response (first 3 stations):

<Stations>
  <Station>
    <Code>HT</Code>
    <Type>knooppuntIntercitystation</Type>
    <Namen>
      <Kort>H'bosch</Kort>
      <Middel>'s-Hertogenbosch</Middel>
      <Lang>'s-Hertogenbosch</Lang>
    </Namen>
    <Land>NL</Land>
    <UICCode>8400319</UICCode>
    <Lat>51.690556</Lat>
    <Lon>5.293611</Lon>
    <Synoniemen>
      <Synoniem>Hertogenbosch ('s)</Synoniem>
      <Synoniem>Den Bosch</Synoniem>
    </Synoniemen>
  </Station>
  <Station>
    <Code>HTO</Code>
    <Type>stoptreinstation</Type>
    <Namen>
      <Kort>H'bosch O</Kort>
      <Middel>Hertogenbosch O</Middel>
      <Lang>'s-Hertogenbosch Oost</Lang>
    </Namen>
    <Land>NL</Land>
    <UICCode>8400320</UICCode>
    <Lat>51.700554</Lat>
    <Lon>5.318333</Lon>
    <Synoniemen>
      <Synoniem>Hertogenbosch Oost ('s)</Synoniem>
      <Synoniem>Den Bosch Oost</Synoniem>
    </Synoniemen>
  </Station>
  <Station>
    <Code>HDE</Code>
    <Type>stoptreinstation</Type>
    <Namen>
      <Kort>'t Harde</Kort>
      <Middel>'t Harde</Middel>
      <Lang>'t Harde</Lang>
    </Namen>
    <Land>NL</Land>
    <UICCode>8400388</UICCode>
    <Lat>52.40917</Lat>
    <Lon>5.893611</Lon>
    <Synoniemen>
      <Synoniem>Harde ('t)</Synoniem>
    </Synoniemen>
  </Station>
</Stations>