---
title: "Retrieve headway data for the given date and stop(s)."
method: GET
path: "/api/headways/{user_date}"
tags: ["/api"]
---

# Retrieve headway data for the given date and stop(s).

`GET /api/headways/{user_date}`

Args:
  user_date: Date string in "YYYY-MM-DD" format.
  Query params - stop: One or more stop IDs.

Returns:
  Response: JSON response containing headway event data.

## Response `200`

Success

- HeadwayResponse — Response for `/api/headways/{date}` — raw headway events for a single day. Attributes: headways: Headway data keyed by stop ID.
  - `headways` object, required

---

[API](https://skmtc.net/transitmatters/apis/data-dashboard-api.md) · [All operations](https://skmtc.net/transitmatters/apis/data-dashboard-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/transitmatters/data-dashboard-api/versions/4bc220e599eb/schema)