---
title: "Get Milestones"
method: GET
path: "/milestones"
tags: ["milestone"]
---

# Get Milestones

`GET /milestones`

Minimum start date to filter milestones. Format: RFC3339 timestamp

## Query parameters

- `limit` integer, required
- `minimum_start_date` string, date-time
- `category` string
- `competition` string
- `source_id` string
- `type` string
- `related_event_ticker` string
- `cursor` string
- `min_updated_ts` integer

## Response `200`

Milestones retrieved successfully

- GetMilestonesResponse
  - `milestones` Milestone[], required — List of milestones.
    - `id` string, required — Unique identifier for the milestone.
    - `category` string, required — Category of the milestone. E.g. Sports, Elections, Esports, Crypto.
    - `type` string, required — Type of the milestone. E.g. football_game, basketball_game, soccer_tournament_multi_leg, baseball_game, hockey_match, golf_tournament, political_race.
    - `start_date` string, date-time, required — Start date of the milestone.
    - `end_date` string, date-time, nullable — End date of the milestone, if any.
    - `related_event_tickers` string[], required — List of event tickers related to this milestone.
    - `title` string, required — Title of the milestone.
    - `notification_message` string, required — Notification message for the milestone.
    - `source_id` string, nullable — Source id of milestone if available.
    - `source_ids` object — Source ids of milestone if available.
    - `details` object, required — Additional details about the milestone.
    - `primary_event_tickers` string[], required — List of event tickers directly related to the outcome of this milestone.
    - `last_updated_ts` string, date-time, required — Last time this structured target was updated.
  - `cursor` string — Cursor for pagination.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.net/kalshi/apis/kalshi-trade-api-manual-endpoints.md) · [All operations](https://skmtc.net/kalshi/apis/kalshi-trade-api-manual-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kalshi/kalshi-trade-api-manual-endpoints/versions/6e6402bf667d/schema)