🛣️Navigation

Gets a navigation route from a starting platform to an ending platform.

Parameters

All transfers to different routes must be specified in the transfers parameter.

Transferring between 2 different stations via a non-rail method (e.g. Citylink between City Hall and Esplanade) is NOT supported.

For the transfers parameter, the code for the station that the user is arriving at should be used.

For example, when transferring from the East-West Line to the Circle Line at Paya Lebar (EW8/CC9), EW8 it should be listed instead of CC9.

key	type	value	example
start	string	The station code where the user is departing from. For interchange stations, the code for the line the user will depart from is used.	EW3
end	string	The station code where the user is alighting at. The code for the line that the user is alighting at is used for interchange stations.	NS12
transfers	string[]	A list of comma-separated station codes where the user is transferring. It is only used when the navigation mode is fixed.	EW8,CC15
mode	string	The preferred mode for the user to travel with — defaults to escalator (either escalator, lift or stairs).	escalator
navmode	string	The navigation mode used — defaults to fixed (either fixed, shortest or leasttransfer).	fixed

The fixed navigation mode is ONLY used when the user wants to state which interchange station they are transferring to.

If not, either shortest or leasttransfer has to be specified.

Example Navigation URL

https://api.mrtinfo.sg/v1/doors/navigate?start=CG1&end=NS4&navmode=leasttransfer

[
  {
    "name": "Expo",
    "allCodes": [
      "DT35",
      "CG1"
    ],
    "line": "DT",
    "towards": "DT-11",
    "crossPlatform": false,
    "doors": [
      5
    ]
  },
  {
    "name": "Newton",
    "allCodes": [
      "NS21",
      "DT11"
    ],
    "line": "NS",
    "towards": "NS-4",
    "crossPlatform": false,
    "doors": [
      8,
      19
    ]
  }
]

The doors array in each station indicates the doors that the user should enter at that station.

Responses

Gets a navigation route from a starting platform to an ending platform.

GET https://api.mrtinfo.sg/v1/doors/navigate

Path Parameters

Name	Type	Description
start*	String	The station code where the user is departing from. For interchange stations, the code for the line the user will depart from is used.
navmode	String	The navigation mode used — defaults to fixed (either fixed, shortest or leasttransfer).
mode	String	The preferred mode for the user to travel with — defaults to escalator (either escalator, lift or stairs).
transfers	String[]	A list of comma-separated station codes where the user is transferring. It is only used when the navigation mode is fixed.
end*	String	The station code where the user is alighting at. The code for the line that the user is alighting at is used for interchange stations.

200: OK An array of navigation objects for the route requested.

502: Bad Gateway

400: Bad Request One or more query parameters is missing or incorrect.

404: Not Found No possible navigation route can be found with the starting, ending and transferring stations specified.

500: Internal Server Error Server / Database error

429: Too Many Requests Rate limit exceeded

Note

Won't work for Jurong Region Line - Damn you, Bahar junction

(Should be fixed now, will check again in 2028)