Main navigation

Go to content

Documentation: prices

The web-service for prices can be used to request price information for a train journey.


The web-service for prices can be used to request price information for a train journey. N.B. Separate authorisation is required prior to using this web-service. This authorisation is given upon submission of a signed contract. You can request this contract from nsr.api@ns.nl.

This procedure aims to make users of the NS-API aware of the correct interpretation of the prices-service in combination with the corresponding train journey recommendations, in order to prevent NS customers from being provided with incorrect information.

Release notes

05-03-2012: Added new element Products/RateUnits in version 2.

26-07-2012: Added authorisation requirement.

06-06-2014: Version 3 introduced due to implementation of interoperable prices.

08-10-2014: Added new element Carrierchoice/RateUnits in version 3.

08-11-2014: Version 2 phased out.

Request

Price information can be obtained using the following url:

http://webservices.ns.nl/ns-api-prijzen-v3?from=${Station's name or abbreviation}&to=${Station's name or abbreviation}&via=${Station's name or abbreviation}&date=${Date in ddMMyyyy format}

The url above is for version 3 of this web-service. Version 1 and 2 are no longer available.

Parameter Description Required
from The code (abbreviation) or short name or medium-length name or full name or synonym of the departure station Yes
to The code (abbreviation) or short name or medium-length name or full name or synonym of the arrival station Yes
via The code (abbreviation) or short name or medium-length name or full name or synonym of the departure station No
dateTime The date in ddMMyyyy format No

Response

An example of a request:

http://webservices.ns.nl/ns-api-prijzen-v3?from=rtd&to=gdm

Gives the following response:

<?xml version="1.0" encoding="UTF-8" ?>
  <VervoerderKeuzes>
    <VervoerderKeuze naam="MEEST_NS">
      <Tariefeenheden>82</Tariefeenheden>
      <ReisType name="Retour">
        <ReisKlasse klasse="1">
          <Prijsdeel vervoerder="NS" prijs="47.20" naar="GDM" van="RTD"/>
          <Totaal>47.20</Totaal>
          <Korting>
            <Kortingsprijs name="vol tarief" prijs="47.20"/>
            <Kortingsprijs name="20% korting" prijs="37.80"/>
            <Kortingsprijs name="40% korting" prijs="28.40"/>
          </Korting>
        </ReisKlasse>
        <ReisKlasse klasse="2">
          <Prijsdeel vervoerder="NS" prijs="27.80" naar="GDM" van="RTD"/>
          <Totaal>27.80</Totaal>
          <Korting>
            <Kortingsprijs name="vol tarief" prijs="27.80"/>
            <Kortingsprijs name="20% korting" prijs="22.20"/>
            <Kortingsprijs name="40% korting" prijs="16.60"/>
          </Korting>
        </ReisKlasse>
      </ReisType>
      <ReisType name="Enkele reis">
        <ReisKlasse klasse="1">
          <Prijsdeel vervoerder="NS" prijs="23.60" naar="GDM" van="RTD"/>
          <Totaal>23.60</Totaal>
          <Korting>
            <Kortingsprijs name="vol tarief" prijs="23.60"/>
            <Kortingsprijs name="20% korting" prijs="18.90"/>
            <Kortingsprijs name="40% korting" prijs="14.20"/>
          </Korting>
        </ReisKlasse>
        <ReisKlasse klasse="2">
          <Prijsdeel vervoerder="NS" prijs="13.90" naar="GDM" van="RTD"/>
          <Totaal>13.90</Totaal>
          <Korting>
            <Kortingsprijs name="vol tarief" prijs="13.90"/>
            <Kortingsprijs name="20% korting" prijs="11.10"/>
            <Kortingsprijs name="40% korting" prijs="8.30"/>
          </Korting>
        </ReisKlasse>
      </ReisType>
    </VervoerderKeuze>
    <VervoerderKeuze naam="ANDERE_VERVOERDER">
      <Tariefeenheden>69</Tariefeenheden>
      <ReisType name="Retour">
        <ReisKlasse klasse="1">
          <Prijsdeel vervoerder="NS" prijs="12.20" naar="DDR" van="RTD"/>
          <Prijsdeel vervoerder="ARRIVA" prijs="17.51" naar="GDM" van="DDR"/>
          <Totaal>29.71</Totaal>
          <Korting>
            <Kortingsprijs name="vol tarief" prijs="29.71"/>
            <Kortingsprijs name="20% korting" prijs="23.81"/>
            <Kortingsprijs name="40% korting" prijs="17.80"/>
          </Korting>
        </ReisKlasse>
        <ReisKlasse klasse="2">
          <Prijsdeel vervoerder="NS" prijs="7.20" naar="DDR" van="RTD"/>
          <Prijsdeel vervoerder="ARRIVA" prijs="17.51" naar="GDM" van="DDR"/>
          <Totaal>24.71</Totaal>
          <Korting>
            <Kortingsprijs name="vol tarief" prijs="24.71"/>
            <Kortingsprijs name="20% korting" prijs="19.81"/>
            <Kortingsprijs name="40% korting" prijs="14.70"/>
          </Korting>
        </ReisKlasse>
      </ReisType>
      <ReisType name="Enkele reis">
        <ReisKlasse klasse="1">
          <Prijsdeel vervoerder="NS" prijs="7.00" naar="DDR" van="RTD"/>
          <Prijsdeel vervoerder="ARRIVA" prijs="8.26" naar="GDM" van="DDR"/>
          <Totaal>15.26</Totaal>
          <Korting>
            <Kortingsprijs name="vol tarief" prijs="15.26"/>
            <Kortingsprijs name="20% korting" prijs="12.21"/>
            <Kortingsprijs name="40% korting" prijs="9.15"/>
          </Korting>
        </ReisKlasse>
        <ReisKlasse klasse="2">
          <Prijsdeel vervoerder="NS" prijs="4.10" naar="DDR" van="RTD"/>
          <Prijsdeel vervoerder="ARRIVA" prijs="8.26" naar="GDM" van="DDR"/>
          <Totaal>12.36</Totaal>
          <Korting>
            <Kortingsprijs name="vol tarief" prijs="12.36"/>
            <Kortingsprijs name="20% korting" prijs="9.91"/>
            <Kortingsprijs name="40% korting" prijs="7.35"/>
          </Korting>
        </ReisKlasse>
      </ReisType>
    </VervoerderKeuze>
    <VervoerderKeuze naam="VRIJE_ROUTE">
      <Tariefeenheden>82</Tariefeenheden>
      <ReisType name="Retour">
        <ReisKlasse klasse="1">
          <Prijsdeel prijs="47.20" naar="GDM" van="RTD"/>
          <Totaal>47.20</Totaal>
          <Korting>
            <Kortingsprijs name="vol tarief" prijs="47.20"/>
            <Kortingsprijs name="20% korting" prijs="37.80"/>
            <Kortingsprijs name="40% korting" prijs="28.40"/>
          </Korting>
        </ReisKlasse>
        <ReisKlasse klasse="2">
          <Prijsdeel prijs="27.80" naar="GDM" van="RTD"/>
          <Totaal>27.80</Totaal>
          <Korting>
            <Kortingsprijs name="vol tarief" prijs="27.80"/>
            <Kortingsprijs name="20% korting" prijs="22.20"/>
            <Kortingsprijs name="40% korting" prijs="16.60"/>
          </Korting>
        </ReisKlasse>
      </ReisType>
      <ReisType name="Enkele reis">
        <ReisKlasse klasse="1">
          <Prijsdeel prijs="23.60" naar="GDM" van="RTD"/>
          <Totaal>23.60</Totaal>
          <Korting>
            <Kortingsprijs name="vol tarief" prijs="23.60"/>
            <Kortingsprijs name="20% korting" prijs="18.90"/>
            <Kortingsprijs name="40% korting" prijs="14.20"/>
          </Korting>
        </ReisKlasse>
        <ReisKlasse klasse="2">
          <Prijsdeel prijs="13.90" naar="GDM" van="RTD"/>
          <Totaal>13.90</Totaal>
          <Korting>
            <Kortingsprijs name="vol tarief" prijs="13.90"/>
            <Kortingsprijs name="20% korting" prijs="11.10"/>
            <Kortingsprijs name="40% korting" prijs="8.30"/>
          </Korting>
        </ReisKlasse>
      </ReisType>
    </VervoerderKeuze>
  </VervoerderKeuzes>