Skip to main content
GET
/
milestones
Get Milestones
curl --request GET \
  --url https://api.elections.kalshi.com/trade-api/v2/milestones
{
  "milestones": [
    {
      "id": "<string>",
      "category": "<string>",
      "type": "<string>",
      "start_date": "2023-11-07T05:31:56Z",
      "related_event_tickers": [
        "<string>"
      ],
      "title": "<string>",
      "notification_message": "<string>",
      "details": {},
      "primary_event_tickers": [
        "<string>"
      ],
      "last_updated_ts": "2023-11-07T05:31:56Z",
      "end_date": "2023-11-07T05:31:56Z",
      "source_id": "<string>"
    }
  ],
  "cursor": "<string>"
}

Query Parameters

limit
integer
required

Number of milestones to return per page

Required range: 1 <= x <= 500
minimum_start_date
string<date-time>

Minimum start date to filter milestones. Format RFC3339 timestamp

category
string

Filter by milestone category

competition
string

Filter by competition

source_id
string

Filter by source id

type
string

Filter by milestone type

Filter by related event ticker

cursor
string

Pagination cursor. Use the cursor value returned from the previous response to get the next page of results

Response

Milestones retrieved successfully

milestones
object[]
required

List of milestones.

cursor
string

Cursor for pagination.