Share via

Nederlandse Spoorwegen (Independent Publisher) (Preview)

Retrieve information from the main Dutch railway operator.

This connector is available in the following products and regions:

Service Class Regions
Copilot Studio Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Logic Apps Standard All Logic Apps regions except the following:
     -   Azure Government regions
     -   Azure China regions
     -   US Department of Defense (DoD)
Power Apps Premium All Power Apps regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Power Automate Premium All Power Automate regions except the following:
     -   US Government (GCC)
     -   US Government (GCC High)
     -   China Cloud operated by 21Vianet
     -   US Department of Defense (DoD)
Contact
Name Miguel Verweij
URL https://www.powerplatformchallenge.com
Email miguel.verweij@powerbouwer.com
Connector Metadata
Publisher Miguel Verweij
Website https://apiportal.ns.nl/
Privacy policy https://www.ns.nl/en/privacy
Categories Data

Creating a connection

The connector supports the following authentication types:
Default Parameters for creating connection. All regions Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name Type Description Required
API Key securestring The API key issued by Nederlandse Spoorwegen. True

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds

Actions

Arrivals

List of arrivals for a specific station.
Departures

List of departures for a specific station.
Station Disruptions

List of disruptions relevant for a station.
Stations

List of stations.

Arrivals

Operation ID:
GetArrivals

List of arrivals for a specific station.

Parameters

Name Key Required Type Description
Language
 lang string

Language to use for localizing the arrivals list. Only a small subset of text is translated. Defaults to Dutch.
Station Code
 station string

NS Station code for the station to return arrivals for. Can be left empty if UIC Code parameter is provided.
UIC Code
 uicCode string

UIC code for the station to return arrivals for. Can be left empty if Station Code parameter is provided.
Date Time
 dateTime string

Departure date to show arrivals from in RFC3339 format. Only supported for arrivals at foreign stations. Defaults to server time (Europe/Amsterdam)
Max Arrivals
 maxJourneys integer

Number of arrivals to return. Defaults to 40.

Returns

Name Path Type Description
Source
 payload.source string

Source of the response.
arrivals
 payload.arrivals array of object

arrivals
Origin
 payload.arrivals.origin string

Origin station of the arriving train.
Name
 payload.arrivals.name string

Name of the arriving train.
Planned Date Time
 payload.arrivals.plannedDateTime string

Planned date time of the arriving train.
Planned Time Zone Offset
 payload.arrivals.plannedTimeZoneOffset integer

Planned time zone offset of the arriving train.
Actual Date Time
 payload.arrivals.actualDateTime string

Actual date time.
Actual Time Zone Offset
 payload.arrivals.actualTimeZoneOffset integer

Time zone offset of actual time.
Planned Track
 payload.arrivals.plannedTrack string

Planned track of the arriving train.
Train Number
 payload.arrivals.product.number string

Train number of the arriving train.
Category Code
 payload.arrivals.product.categoryCode string

Category code of the arriving train.
Short Category Name
 payload.arrivals.product.shortCategoryName string

Short category name of the arriving train.
Long Category Name
 payload.arrivals.product.longCategoryName string

Long category name of the arriving train.
Operator Code
 payload.arrivals.product.operatorCode string

Operator code of the arriving train.
Operator Name
 payload.arrivals.product.operatorName string

Operator name of the arriving train.
Train Category
 payload.arrivals.trainCategory string

Category of the arriving train.
Cancelled
 payload.arrivals.cancelled boolean

Boolean indicating if the train has been cancelled.
messages
 payload.arrivals.messages array of object

messages
message
 payload.arrivals.messages.message string

message
style
 payload.arrivals.messages.style string

style
Arrival Status
 payload.arrivals.arrivalStatus string

Arrival status of the train.
Actual Track
 payload.arrivals.actualTrack string

Actual Track of the arrival.

Departures

Operation ID:
GetDepartures

List of departures for a specific station.

Parameters

Name Key Required Type Description
Language
 lang string

Language to use for localizing the departures list. Only a small subset of text is translated, mainly notes. Defaults to Dutch
Station Code
 station string

NS Station code for the station to return departures for. Can be left empty if UIC Code parameter is provided.
UIC Code
 uicCode string

UIC code for the station to return departures for. Can be left empty if Station Code parameter is provided.
Date Time
 dateTime string

Departure date to show departures from in RFC3339 format. Only supported for departures at foreign stations. Defaults to server time (Europe/Amsterdam).
Max Departures
 maxJourneys string

Number of departures to return. Defaults to 40

Returns

Name Path Type Description
Source
 payload.source string

Source of the response.
departures
 payload.departures array of object

departures
Direction
 payload.departures.direction string

Direction of the departing train.
Name
 payload.departures.name string

Name of the departing train.
Planned Date Time
 payload.departures.plannedDateTime string

Planned date time of the departing train.
Planned Time Zone Offset
 payload.departures.plannedTimeZoneOffset integer

Planned time zone offset of the departing train.
Actual Date Time
 payload.departures.actualDateTime string

Actual date time.
Actual Time Zone Offset
 payload.departures.actualTimeZoneOffset integer

Time zone offset of actual time.
Planned Track
 payload.departures.plannedTrack string

Planned track of the arriving train.
Train Number
 payload.departures.product.number string

Train number of the departing train.
Category Code
 payload.departures.product.categoryCode string

Category code of the departing train.
Short Category Name
 payload.departures.product.shortCategoryName string

Short category name of the departing train.
Long Category Name
 payload.departures.product.longCategoryName string

Long category name of the departing train.
Operator Code
 payload.departures.product.operatorCode string

Operator code of the departing train.
Operator Name
 payload.departures.product.operatorName string

Operator name of the departing train.
Type
 payload.departures.product.type string

Type of the departing train.
Train Category
 payload.departures.trainCategory string

Category of the departing train.
Cancelled
 payload.departures.cancelled boolean

Boolean indicating if the train has been cancelled.
routeStations
 payload.departures.routeStations array of object

routeStations
uicCode
 payload.departures.routeStations.uicCode string

uicCode
mediumName
 payload.departures.routeStations.mediumName string

mediumName
messages
 payload.departures.messages array of

messages
Departure Status
 payload.departures.departureStatus string

Departure status of the train.

Station Disruptions

Operation ID:
GetStationDisruptions

List of disruptions relevant for a station.

Parameters

Name Key Required Type Description
Station Code
 stationCode True string

NS Station code of the station to return disruptions for.

Returns

Name Path Type Description
array of object
ID
 id string

ID of the disruption.
Title Section Type
 type string

Type of the title section for communicating disruptions.
Registration Time
 registrationTime string

Date time when the disruption is registered.
Release Time
 releaseTime string

Date time when the disruption is released.
Local
 local boolean

Boolean indicating if the disruption is local.
Title
 title string

Title of the disruption.
titleSections
 titleSections array of array

titleSections
items
 titleSections array of object
type
 titleSections.type string

type
value
 titleSections.value string

value
Is Active
 isActive boolean

Boolean indicating if the discruption is active.
Start
 start string

Start of the disruption.
End
 end string

End of the disruption.
Period
 period string

Period of the disruption.
Title Section Value
 impact.value integer

Value of the title section for communicating disruptions.
publicationSections
 publicationSections array of object

publicationSections
stations
 publicationSections.section.stations array of object

stations
uicCode
 publicationSections.section.stations.uicCode string

uicCode
stationCode
 publicationSections.section.stations.stationCode string

stationCode
name
 publicationSections.section.stations.name string

name
lat
 publicationSections.section.stations.coordinate.lat float

lat
lng
 publicationSections.section.stations.coordinate.lng float

lng
countryCode
 publicationSections.section.stations.countryCode string

countryCode
direction
 publicationSections.section.direction string

direction
stations
 publicationSections.consequence.section.stations array of object

stations
uicCode
 publicationSections.consequence.section.stations.uicCode string

uicCode
stationCode
 publicationSections.consequence.section.stations.stationCode string

stationCode
name
 publicationSections.consequence.section.stations.name string

name
lat
 publicationSections.consequence.section.stations.coordinate.lat float

lat
lng
 publicationSections.consequence.section.stations.coordinate.lng float

lng
countryCode
 publicationSections.consequence.section.stations.countryCode string

countryCode
direction
 publicationSections.consequence.section.direction string

direction
description
 publicationSections.consequence.description string

description
level
 publicationSections.consequence.level string

level
sectionType
 publicationSections.sectionType string

sectionType
timespans
 timespans array of object

timespans
start
 timespans.start string

start
end
 timespans.end string

end
period
 timespans.period string

period
label
 timespans.situation.label string

label
label
 timespans.cause.label string

label
advices
 timespans.advices array of string

advices
alternativeTransportTimespans
 alternativeTransportTimespans array of

alternativeTransportTimespans

Stations

Operation ID:
GetStations

List of stations.

Returns

Name Path Type Description
payload
 payload array of object

payload
UIC Code
 payload.UICCode string

UIC code of the station.
Station Type
 payload.stationType string

Type of the station.
EVA Code
 payload.EVACode string

EVA Code of the station.
Station Code
 payload.code string

Code of the station.
sporen
 payload.sporen array of object

sporen
spoorNummer
 payload.sporen.spoorNummer string

spoorNummer
synoniemen
 payload.synoniemen array of string

synoniemen
Has Facilities
 payload.heeftFaciliteiten boolean

Boolean indicating if the station has facilities.
Has Departure Times
 payload.heeftVertrektijden boolean

Boolean indicating if the station has departure timing.
Has Travel Assistance
 payload.heeftReisassistentie boolean

Boolean indicating if the station has travel assistance.
Full Name
 payload.namen.lang string

Full name of the station.
Short Name
 payload.namen.kort string

Short name of the station.
Country
 payload.land string

County code of the station.
Latitude
 payload.lat float

Latitude of the station.
Longitude
 payload.lng float

Longitude of the station.
Radius
 payload.radius integer

Radius of the station.
Approach Radius
 payload.naderenRadius integer

Approach radius of the station.