NS reisinformatie

Basisadres

https://gateway.apiportal.ns.nl/reisinformatie-api

Endpoints 15

• GET/api/v3/tripsTrips
• GET/api/v3/trips/tripSingle trip
• GET/api/v3/trips/booked-tripBooked trip
• GET/api/v3/priceDomestic prices (verouderd)
• GET/api/v3/disruptionsDisruptions (verouderd)
• GET/api/v3/disruptions/{type}/{id}Single disruption (verouderd)
• GET/api/v3/disruptions/station/{stationCode}Station disruptions (verouderd)
• GET/api/v2/stationsStations (verouderd)
• GET/api/v2/stations/nearestGet stations closest to provided coordinates (verouderd)
• GET/api/v2/priceDomestic prices
• GET/api/v2/journeyJourney details
• GET/api/v2/departuresDepartures (verouderd)
• GET/api/v2/arrivalsArrivals (verouderd)
• GET/api/v1/calamitiesCalamities (verouderd)
• GET/api/openapiOpenAPI Spec

Meer API's met dezelfde sleutel 4 · uit de documentatie van de aanbieder uit de beschrijving

Filteren uit de beschrijving

Geen algemene filtertaal: elk endpoint heeft zijn eigen query-parameters (zie hieronder).

Parameters 30

Limieten en valkuilen

• De beschrijving noemt als server https://apigateway.ns.nl/reisinformatie-api, maar de werkende gateway is https://gateway.apiportal.ns.nl/reisinformatie-api. getest
• 300 verzoeken per 5 minuten voor niet-betalende gebruikers; daarboven HTTP 429 met een Retry-After-kop. uit de beschrijving
• De NS-voorwaarden verbieden het NS-logo in je toepassing en het zo bewerken van gegevens dat er onjuiste informatie ontstaat. uit de beschrijving
• Antwoorden komen gecomprimeerd (gzip); gebruik curl --compressed of een client die dat zelf uitpakt. getest
• Arrivals en departures in deze API zijn verouderd: NS verwijst naar https://gateway.apiportal.ns.nl/timetable-api/v2/. uit de beschrijving
• Het NS-portaal toont de API-definities alleen na inloggen; alleen de spec van de Reisinformatie-API is via de gateway op te vragen. getest

Probeer het HTTP 200 · 315 ms · 16 okt

https://gateway.apiportal.ns.nl/reisinformatie-api/api/v2/departures?station=UT&maxJourneys=2

{
  "payload": {
    "source": "DVS",
    "departures": [
      {
        "direction": "Venlo",
        "name": "NS  3525",
        "plannedDateTime": "2026-10-16T08:24:00+0200",
        "plannedTimeZoneOffset": 120,
        "actualDateTime": "2026-10-16T08:24:00+0200",
        "actualTimeZoneOffset": 120,
        "plannedTrack": "18",
        "actualTrack": "18",
        "product": {
          "number": "3525",
          "categoryCode": "IC",
          "shortCategoryName": "NS Intercity",
          "longCategoryName": "Intercity",
          "operatorName": "NS",
          "operatorCode": "NS",
          "type": "TRAIN"
        },
        "trainCategory": "IC",
        "cancelled": false,
        "routeStations": [
          {
            "uicCode": "8400319",
            "mediumName": "'s-Hertogenbosch"
          },
          {
            "uicCode": "8400206",
            "mediumName": "Eindhoven C."
          }
        ],
        "messages": [],
        "departureStatus": "ON_STATION"
      },
      {
        "direction": "Zaandam",
        "name": "NS  2722",

Ingekort antwoord, opgeslagen bij het oogsten. Klik op het adres voor het echte, actuele antwoord.