Sdílet prostřednictvím


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

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

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

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

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.