# List Event Milestones

Retrieves a paginated list of milestones (individual game or economic release events). Each milestone contains match details, team info, and related event contract symbols.

# OpenAPI definition

```json
{
  "info": {
    "title": "Webull Open API Reference",
    "description": "application.yml\\ncom\\ni18n\\nMETA-INF\\nstatic\\n\\r\\n",
    "contact": {
      "name": "",
      "url": "",
      "email": ""
    },
    "version": "2.0",
    "x-logo": {
      "url": "static/png/logo.png"
    }
  },
  "servers": [
    {
      "url": "https://us-global-openapi.uat.webullbroker.com"
    }
  ],
  "path": "/market-data/instruments/event-contracts/milestones/list",
  "method": "get",
  "tags": [
    "Instruments"
  ],
  "description": "Retrieves a paginated list of milestones (individual game or economic release events). Each milestone contains match details, team info, and related event contract symbols.",
  "operationId": "milestonesUsingGET",
  "parameters": [
    {
      "name": "minimum_start_date",
      "in": "query",
      "description": "Query data with match start time (millisecond timestamp) that is later than that time.",
      "required": false,
      "schema": {
        "type": "integer",
        "format": "int64"
      },
      "example": 1715100000000
    },
    {
      "name": "category",
      "in": "query",
      "description": "category code",
      "required": false,
      "schema": {
        "type": "string"
      },
      "example": "SPORTS"
    },
    {
      "name": "competition",
      "in": "query",
      "description": "competition name",
      "required": false,
      "schema": {
        "type": "string"
      },
      "example": "College Football"
    },
    {
      "name": "related_event_symbol",
      "in": "query",
      "description": "related event symbol",
      "required": false,
      "schema": {
        "type": "string"
      },
      "example": "KXNCAAFGAME-26AUG29UNCTCU"
    },
    {
      "name": "pagination_key",
      "in": "query",
      "description": "Pagination key returned from previous page response. Pass null or omit for first page.",
      "required": false,
      "schema": {
        "type": "string"
      },
      "example": "eyJ2IjoxLCJwYWdlSW5kZXgiOjJ9"
    },
    {
      "name": "access_token",
      "in": "header",
      "description": "User's authenticated token.",
      "required": true,
      "schema": {
        "type": "string"
      }
    },
    {
      "name": "reqid",
      "in": "header",
      "description": "The unique ID for this request. Suggest using UUID.",
      "schema": {
        "type": "string"
      },
      "example": "2e46d5a4-bef9-4507-8cda-98f85d2f770c"
    }
  ],
  "responses": {
    "200": {
      "description": "OK",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "description": "Data list",
                "items": {
                  "type": "object",
                  "properties": {
                    "category": {
                      "type": "string",
                      "description": "Category Code",
                      "example": "SPORTS"
                    },
                    "type": {
                      "type": "string",
                      "description": "Milestone type",
                      "example": "football_game"
                    },
                    "title": {
                      "type": "string",
                      "description": "Milestone title",
                      "example": "North Carolina at TCU"
                    },
                    "details": {
                      "type": "object",
                      "additionalProperties": {
                        "type": "object",
                        "description": "Detail fields vary by type. Refer to SportsGameDetails when type=$SPORTS_GAME, EconomicReleaseDetails when type=ECONOMIC_RELEASE.",
                        "oneOf": [
                          {
                            "type": "object",
                            "properties": {
                              "venue": {
                                "type": "string",
                                "description": "Venue of the game",
                                "example": "Amon G. Carter Stadium"
                              },
                              "home_team_id": {
                                "type": "string",
                                "description": "Home team ID",
                                "example": "NCAAF:TCU"
                              },
                              "home_team_name": {
                                "type": "string",
                                "description": "Home team full name",
                                "example": "TCU Horned Frogs"
                              },
                              "home_team_short_name": {
                                "type": "string",
                                "description": "Home team short name",
                                "example": "TCU"
                              },
                              "away_team_id": {
                                "type": "string",
                                "description": "Away team ID",
                                "example": "NCAAF:UNC"
                              },
                              "away_team_name": {
                                "type": "string",
                                "description": "Away team full name",
                                "example": "North Carolina Tar Heels"
                              },
                              "away_team_short_name": {
                                "type": "string",
                                "description": "Away team short name",
                                "example": "UNC"
                              }
                            },
                            "description": "Details when type=SPORTS_GAME",
                            "title": "SportsGameDetails"
                          },
                          {
                            "type": "object",
                            "properties": {
                              "source": {
                                "type": "string",
                                "description": "Data source institution",
                                "example": "Bureau of Labor Statistics"
                              },
                              "indicator": {
                                "type": "string",
                                "description": "Economic indicator name",
                                "example": "Non-Farm Payrolls"
                              }
                            },
                            "description": "Details when type=ECONOMIC_RELEASE",
                            "title": "EconomicReleaseDetails"
                          }
                        ]
                      },
                      "description": "Detail fields vary by type. Refer to SportsGameDetails when type=$SPORTS_GAME, EconomicReleaseDetails when type=ECONOMIC_RELEASE."
                    },
                    "status": {
                      "type": "string",
                      "description": "status, eg:NOT_STARTED,INPROGRESS,CLOSED,CANCELLED,POSTPONED,DELAYED,SUSPENDED,UNKNOWN",
                      "example": "not_started"
                    },
                    "milestone_id": {
                      "type": "string",
                      "description": "Milestone Unique Identifier",
                      "example": "2526d351-9ffc-4182-8414-495cc84a0b64"
                    },
                    "start_date": {
                      "type": "string",
                      "description": "Start date",
                      "example": "2026-08-29T16:00:00Z"
                    },
                    "end_date": {
                      "type": "string",
                      "description": "End date",
                      "example": "2026-08-29T16:00:00Z"
                    },
                    "related_event_symbols": {
                      "type": "array",
                      "description": "related event symbol",
                      "example": "KXNCAAFGAME-26AUG29UNCTCU",
                      "items": {
                        "type": "string",
                        "description": "related event symbol",
                        "example": "KXNCAAFGAME-26AUG29UNCTCU"
                      }
                    },
                    "primary_event_symbols": {
                      "type": "array",
                      "description": "primary event symbol",
                      "example": "KXNCAAFGAME-26AUG29UNCTCU",
                      "items": {
                        "type": "string",
                        "description": "primary event symbol",
                        "example": "KXNCAAFGAME-26AUG29UNCTCU"
                      }
                    }
                  },
                  "description": "Data list",
                  "title": "MilestoneVo"
                }
              },
              "pagination_key": {
                "type": "string",
                "description": "Pagination key for next page. null means no more data.",
                "example": "eyJ2IjoxLCJwYWdlSW5kZXgiOjJ9"
              }
            },
            "title": "MilestoneVoPageResponse"
          }
        }
      }
    }
  },
  "postman": {
    "name": "List Event Milestones",
    "description": {
      "content": "Retrieves a paginated list of milestones (individual game or economic release events). Each milestone contains match details, team info, and related event contract symbols.",
      "type": "text/plain"
    },
    "url": {
      "path": [
        "market-data",
        "instruments",
        "event-contracts",
        "milestones",
        "list"
      ],
      "host": [
        "{{baseUrl}}"
      ],
      "query": [
        {
          "disabled": false,
          "description": {
            "content": "Query data with match start time (millisecond timestamp) that is later than that time.",
            "type": "text/plain"
          },
          "key": "minimum_start_date",
          "value": ""
        },
        {
          "disabled": false,
          "description": {
            "content": "category code",
            "type": "text/plain"
          },
          "key": "category",
          "value": ""
        },
        {
          "disabled": false,
          "description": {
            "content": "competition name",
            "type": "text/plain"
          },
          "key": "competition",
          "value": ""
        },
        {
          "disabled": false,
          "description": {
            "content": "related event symbol",
            "type": "text/plain"
          },
          "key": "related_event_symbol",
          "value": ""
        },
        {
          "disabled": false,
          "description": {
            "content": "Pagination key returned from previous page response. Pass null or omit for first page.",
            "type": "text/plain"
          },
          "key": "pagination_key",
          "value": ""
        }
      ],
      "variable": []
    },
    "header": [
      {
        "disabled": false,
        "description": {
          "content": "(Required) User's authenticated token.",
          "type": "text/plain"
        },
        "key": "access_token",
        "value": ""
      },
      {
        "disabled": false,
        "description": {
          "content": "The unique ID for this request. Suggest using UUID.",
          "type": "text/plain"
        },
        "key": "reqid",
        "value": ""
      },
      {
        "key": "Accept",
        "value": "application/json"
      }
    ],
    "method": "GET"
  }
}
```