NRE Darwin Web Service (Staff)

About

The Darwin Web Service (Staff) is a SOAP API which allows access to more detailed information about arrivals and departures from a station. The additional data available includes train reporting numbers (colloquially called 'headcodes'), schedule UIDs and Retail Service IDs (RSID), plus passing points for trains.

This is the same data that is presented on the Darwin Web Service (Public), but in greater detail.

Having problems with the API? Check out the troubleshooting notes.

API

Documentation for the LDB-SV can be found [here http://lite.realtime.nationalrail.co.uk/openldbsvws/]. A previous edition as a PDF document from May 2016 can be found here: LDB-SV User Guide. Further guidance and advice can be found here LDBSVWS - Guidance Note v1. Whilst last updated in 2014, much of the information is still current and correct. An updated version will be added to this site in due course.

The API uses SOAP, which is not necessarily a developer's first choice.

Example code to consume the service is available for the following languages:

• Java using Apache CXF

Detail

The OpenLDB (Staff) provides SOAP 1.1 and 1.2 endpoints which supports the following operations;

GetArrBoardWithDetails
GetArrDepBoardWithDetails
GetArrivalBoardByCRS
GetArrivalBoardByTIPLOC
GetArrivalDepartureBoardByCRS
GetArrivalDepartureBoardByTIPLOC
GetDepartureBoardByCRS
GetDepartureBoardByTIPLOC
GetDepBoardWithDetails
GetFastestDepartures
GetFastestDeparturesWithDetails
GetNextDepartures
GetNextDeparturesWithDetails
GetServiceDetailsByRID
QueryServices

GetHistoricDepartureBoard
GetHistoricServiceDetails
GetHistoricTimeLine
QueryHistoricServices

GetSourceInstanceNames
GetStationList
GetTOCList
GetDisruptionList
GetReasonCodeList
GetReasonCode