# List an event's players

> The event's team rosters.

Source: https://docs.stxapp.io/apps/api/list-event-players/

> **Availability.** Available on US demo now. See [Environments](https://docs.stxapp.io/environments/).

The event's team rosters. A roster is the team's current roster, not the game-day actives, and is cached for up to 15 minutes. `teams` is empty when the event's type offers no player props or its rosters are not published yet. A player's `player_id` is what `POST /api/v1/markets` takes. `stats` lists the stats on offer for this event, as `GET /api/v1/types` does per event type.

```http
GET /api/v1/events/{event_id}/players
```

Send it with your own demo key: [Try it](/quick-start/?op=events__id_players_get#try-it).

:::note[For apps]
Call it with an OAuth app token (`client_credentials`) carrying `events`. See [Creating markets](/apps/creating-markets/).
:::

:::tip[In the SDKs]
- TypeScript: [`STX.eventPlayers()`](/sdks/typescript/reference/stx/#eventplayers)
- Python: [`STX.event_players()`](/sdks/python/reference/stx/#event_players)
- C#: [`STXClient.GetEventPlayersAsync()`](/sdks/csharp/reference/stx-client/#markets-and-events)
:::

## Parameters

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `event_id` | `path` | string (uuid) | **yes** | The event's UUID. |

## Responses

| Status | Description | Schema |
|---|---|---|
| `200` | Success | object |
| `400` | A parameter was missing or invalid. | Error |
| `401` | No credential, a bad signature or an invalid OAuth access token. Body: {"error":"Missing or invalid API key credentials"}, or for an OAuth token {"error":"Missing or invalid OAuth access token"}. | Error |
| `403` | An OAuth app token without the `events` scope. The account behind this key is not active, for example it is pending approval or suspended. Body: {"error":"Your account is suspended. Contact support."}, the message naming the account's status. | Error |
| `404` | No such event. | Error |

## Example

Request:

```bash
curl --request GET \
  --url 'https://demo.stxapp.io/api/v1/events/{event_id}/players' \
  --header 'Authorization: Bearer <app-access-token>'
```

Response `200`:

```json
{
  "event_id": "24636b3d-f566-4dd3-8c8b-c1a6c2747789",
  "stats": [
    {
      "name": "Total Assists",
      "stat": "ASSISTS"
    },
    {
      "name": "Goals",
      "stat": "GOALS"
    },
    {
      "name": "Shots on Goal",
      "stat": "GOAL_SO"
    },
    {
      "name": "Total Points",
      "stat": "POINTS"
    },
    {
      "name": "Total Saves",
      "stat": "SAVES"
    }
  ],
  "teams": [
    {
      "players": [
        {
          "jersey": "97",
          "name": "Connor McDavid",
          "player_id": "3895074",
          "position": "C"
        },
        {
          "jersey": "2",
          "name": "Evan Bouchard",
          "player_id": "4352722",
          "position": "D"
        },
        {
          "jersey": "29",
          "name": "Leon Draisaitl",
          "player_id": "3114727",
          "position": "C"
        }
      ],
      "team": "Edmonton Oilers"
    },
    {
      "players": [
        {
          "jersey": "71",
          "name": "Macklin Celebrini",
          "player_id": "5206628",
          "position": "C"
        },
        {
          "jersey": "73",
          "name": "Tyler Toffoli",
          "player_id": "5550",
          "position": "C"
        }
      ],
      "team": "San Jose Sharks"
    }
  ]
}
```

### Response fields

| Field | Type | Description |
|---|---|---|
| `event_id` | uuid | The event. |
| `name` | string | The stat's name. |
| `stat` | string | The stat key an entry takes. |