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
Logic Apps	Standard	All Logic Apps regions except the following:      -   Azure Government regions      -   Azure China regions      -   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)
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)

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.