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

# Get Milestones

`GET /milestones`

## Request

- Base URL: `https://external-api.kalshi.com/trade-api/v2`
- URL: `https://external-api.kalshi.com/trade-api/v2/milestones`
- Auth: none declared

Endpoint for listing milestones. A milestone's `details.status`, when present, is maintained by a periodic background job. It lags the game's live state and may be stale or inaccurate, for example remaining `live` after the game ends. For game status, prefer live data, which is updated far more often: `live_data.details.status` from `GET /live_data/milestone/{milestone_id}`, or each entry's `details.status` from `GET /live_data/batch`. Scores are in the sport-specific fields of that live data `details` object.

## 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. `details.status`, when present, is maintained by a periodic background job. It lags the game's live state and may be stale or inaccurate, for example remaining `live` after the game ends. For game status, prefer live data, which is updated far more often: `live_data.details.status` from `GET /live_data/milestone/{milestone_id}`, or each entry's `details.status` from `GET /live_data/batch`. Scores are in the sport-specific fields of that live data `details` object.
    - `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

## Changes

- **2026-03-08** `0efefc7b0f73`: 2 info
  - added the new optional `query` request parameter `min_updated_ts`
  - added the optional property `milestones/items/source_ids` to the response with the `200` status
- **2025-11-06** `6ad7527f54aa`: 3 breaking, 3 warning, 16 info
  - for the `query` request parameter `minimum_start_date`, the format changed from no format to `date-time`
  - the response property `milestones/items/end_date` became nullable for the status `200`
  - the response property `milestones/items/source_id` became nullable for the status `200`
  - for the `query` request parameter `limit`, the max was set to `500.00`
  - …18 more
- **2025-10-17** `32e75b657779`: 1 breaking, 12 info
  - the `milestones/items/` response's property type changed from no type to `object` for status `200`
  - added the optional property `milestones/items/category` to the response with the `200` status
  - added the optional property `milestones/items/details` to the response with the `200` status
  - added the optional property `milestones/items/end_date` to the response with the `200` status
  - …9 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/changes/milestones/get.md)

---

[API](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints.md) - [All operations](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/kalshi/apis/kalshi-trade-api-manual-endpoints/revisions/e6691cdd1915?raw)