---
title: "Bus schedules"
method: GET
path: "/bus/routes/{route_id}/schedules"
tags: ["bus"]
---

# Bus schedules

`GET /bus/routes/{route_id}/schedules`

## Request

- Base URL: `https://api.umd.io/v1`
- URL: `https://api.umd.io/v1/bus/routes/{route_id}/schedules`
- Auth: none declared
- TypeScript: <https://skmtc.dev/umdio/apis/umd-io/docs/bus/routes/:route_id/schedules/get.ts> (a function with typed inputs; its response is checked against the schema)

Get bus schedules for a route

## Path parameters

- `route_id` string, required

## Response `200`

Successful Operation

- BusSchedule[]
  - `days` string: The days the schedule runs
  - `direction` string: Direction id for the route. See Route object.
  - `route` string: Route id
  - `stops` object[]: Scheduled stops on the route.
    - `stop_id` string: Stop id
    - `name` string: Full stop name
  - `trips` array[]: Scheduled stops for the route, and when busses should be stopping there.
    - object[]
      - `stop_id` string: Stop id. See Stop object
      - `arrival_time` string: Arrival time, localized to hh:mm:ss in EST/EDT
      - `arrival_time_secs` string: Time in ms from start of the day

## Other responses

- `400`: Malformed route code
- `404`: Unknown route code

## Changes

- **2026-07-17** `c0fac695dd04`: 1 info
  - api operation id `getLocations` removed and replaced with `getSchedules`
- **2020-04-23** `c645c466611f`: 1 warning, 1 info
  - removed the optional property `items/directions` from the response with the `200` status
  - added the optional property `items/direction` to the response with the `200` status
- **2020-04-19** `1f4fb7230e02`: 1 breaking
  - the response's body type changed from `string` to `array` for status `200`
- **2020-03-31** `b4919cd9fb0d`: 1 info
  - endpoint added
- **2019-07-02** `f2f973dd5f11`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/umdio/apis/umd-io/changes/bus/routes/:route_id/schedules/get.md)

---

[API](https://skmtc.dev/umdio/apis/umd-io.md) - [All operations](https://skmtc.dev/umdio/apis/umd-io/llms.txt) - [OpenAPI document](https://skmtc.dev/umdio/apis/umd-io/revisions/c0fac695dd04?raw)