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>