API docs by Redocly

Journey Planner Service API (v1)

Download OpenAPI specification:

API for UK Rail journey planning

Transfer Patterns

Get transfer patterns

Returns transfer patterns (route skeletons) between stations

query Parameters
origin
required
string
Example: origin=TBW

NLC, TIPLOC or CRS code of journey origin

destination
required
string
Example: destination=EUS

NLC, TIPLOC or CRS code of journey destination

dateTime
string
Default: "now"
Example: dateTime=2025-11-12T12:34

Date and time for pattern lookup (ISO 8601 format, e.g., '2025-11-12T12:34'). Timezone is assumed to be Europe/London. Defaults to the current time if not provided.

via
string
Example: via=EUS,KGX

Comma-separated NLC, TIPLOC or CRS codes of stations to pass through. Each code is one via. For a group station (e.g. the London Terminals NLC), any one of its stations satisfies the via.

avoid
string
Example: avoid=EUS,KGX

Comma-separated NLC, TIPLOC or CRS codes of stations to avoid passing through. When specified, uses the Raptor algorithm for dynamic pattern calculation instead of pre-calculated database patterns.

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "data": [
    ]
}

Service Information

Get current schedule

Returns the current real-time state of a scheduled service

path Parameters
origin
required
string
Example: TBW

Origin station code

destination
required
string
Example: LBG

Destination station code

departure
required
string
Example: 2025-11-12T12:34

Original departure date and time (ISO 8601 format, e.g., '2025-11-12T12:34'). Timezone is assumed to be Europe/London.

arrival
required
string
Example: 2025-11-12T13:23

Original arrival date and time (ISO 8601 format, e.g., '2025-11-12T13:23'). Timezone is assumed to be Europe/London.

rsid
required
string^[A-Z]{2}[0-9]{4,6}$
Example: SE228000

Original RSID of the service

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "data": {
    },
  • "links": { }
}

Get services per TOC

Returns count of services per Train Operating Company (TOC)

query Parameters
from
string
Example: from=TBW

Origin station code (optional filter)

to
string
Example: to=EUS

Destination station code (optional filter). If not provided, defaults to the origin station code.

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "data": {
    }
}

Get service information

Returns detailed information about a specific train service

path Parameters
tuid
required
string^[A-Z]{1}[0-9]{5}$
Example: P19701

Service TUID

date
required
string <date>
Example: 2025-11-12

Service date (YYYY-MM-DD)

Responses

Response samples

Content type
application/json
{
  • "status": "success",
  • "data": {
    }
}