---
title: "View all trip/service runs for a specific run_ref"
method: GET
path: "/v3/runs/{run_ref}"
tags: ["Runs"]
---

# View all trip/service runs for a specific run_ref

`GET /v3/runs/{run_ref}`

## Path parameters

- `run_ref` string, required

## Query parameters

- `include_geopath` boolean
- `expand` integer[]
- `date_utc` string, date-time
- `include_advertised_interchange` boolean
- `token` string
- `devid` string
- `signature` string

## Response `200`

All trip/service run details for the specified run_ref.

- V3RunsResponse
  - `runs` V3Run[] — Individual trips/services of a route
    - `run_id` integer — Numeric trip/service run identifier. Defaults to -1 when run identifier is Alphanumeric
    - `run_ref` string — Alphanumeric trip/service run identifier
    - `route_id` integer — Route identifier
    - `route_type` integer — Transport mode identifier
    - `final_stop_id` integer — stop_id of final stop of run
    - `destination_name` string — Name of destination of run
    - `status` string — Status of metropolitan train run; returns "scheduled" for other modes
    - `direction_id` integer — Direction of travel identifier
    - `run_sequence` integer — Chronological sequence of the trip/service run on the route in direction. Order ascendingly by this field to get chronological order (earliest first) of runs with the same route_id and direction_id.
    - `express_stop_count` integer — The number of remaining skipped/express stations for the run/service from a stop
    - `vehicle_position` V3VehiclePosition
      - `latitude` number, double — Geographic coordinate of latitude of the vehicle when known. May be null. Only available for some bus runs.
      - `longitude` number, double — Geographic coordinate of longitude of the vehicle when known. Only available for some bus runs.
      - `easting` number, double — CIS - Metro Train Vehicle Location Easting coordinate
      - `northing` number, double — CIS - Metro Train Vehicle Location Northing coordinate
      - `direction` string — CIS - Metro Train Vehicle Location Direction
      - `bearing` number, double — Compass bearing of the vehicle when known, clockwise from True North, i.e., 0 is North and 90 is East. May be null. Only available for some bus runs.
      - `supplier` string — Supplier of vehicle position data.
      - `datetime_utc` string, date-time — Date and time that the vehicle position data was supplied.
      - `expiry_time` string, date-time — CIS - Metro Train Vehicle Location data expiry time
    - `vehicle_descriptor` V3VehicleDescriptor
      - `operator` string — Operator name of the vehicle such as "Metro Trains Melbourne", "Yarra Trams", "Ventura Bus Line", "CDC" or "Sita Bus Lines" . May be null/empty. Only available for train, tram, v/line and some bus runs.
      - `id` string — Operator identifier of the vehicle such as "26094". May be null/empty. Only available for some tram and bus runs.
      - `low_floor` boolean — Indicator if vehicle has a low floor. May be null. Only available for some tram runs.
      - `air_conditioned` boolean — Indicator if vehicle is air conditioned. May be null. Only available for some tram runs.
      - `description` string — Vehicle description such as "6 Car Comeng", "6 Car Xtrapolis", "3 Car Comeng", "6 Car Siemens", "3 Car Siemens". May be null/empty. Only available for some metropolitan train runs.
      - `supplier` string — Supplier of vehicle descriptor data.
      - `length` string — The length of the vehicle. Applies to CIS - Metro Trains
    - `geopath` object[] — Geopath of the route
    - `interchange` V3Interchange — When two runs connect
      - `feeder` V3InterchangeRun — Feeder / Distributor details
        - `run_ref` string — Run Identifier
        - `route_id` integer — Route identifier
        - `stop_id` integer — Stop identifier
        - `advertised` boolean — Indicates whether the interchange information is shown to end users
        - `direction_id` integer — Indicates whether the direction for this run
        - `destination_name` string — Indicates the destination name
      - `distributor` V3InterchangeRun — Feeder / Distributor details
        - `run_ref` string — Run Identifier
        - `route_id` integer — Route identifier
        - `stop_id` integer — Stop identifier
        - `advertised` boolean — Indicates whether the interchange information is shown to end users
        - `direction_id` integer — Indicates whether the direction for this run
        - `destination_name` string — Indicates the destination name
    - `run_note` string — Additional descriptive text associated with the run
    - `externalService` 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10
  - `status` V3Status
    - `version` string — API Version number
    - `health` 0 | 1 — API system health status (0=offline, 1=online)

## Other responses

- `400` — Invalid Request
- `403` — Access Denied

---

[API](https://skmtc.dev/gov/apis/ptv-timetable-api-version-3.md) · [All operations](https://skmtc.dev/gov/apis/ptv-timetable-api-version-3/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gov/ptv-timetable-api-version-3/revisions/fe82d30d47ea/schema)