List an event's players

The event’s team rosters and the stats a player-prop market on it can be created on. 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 and a stat are what POST /api/v1/markets takes.

GET

https://demo.stxapp.iohttps://demo.stxapp.cahttps://api.on.stxapp.ca/api/v1/events/{event_id}/players

ISV only

Call it with an OAuth app token (client_credentials) carrying events. See Creating markets.

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:

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

Response 200:

{
  "event_id": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
  "stats": [
    {
      "name": "Rushing Yards",
      "stat": "RUSH_YDS"
    }
  ],
  "teams": [
    {
      "players": [
        {
          "jersey": null,
          "name": null,
          "player_id": null,
          "position": null
        }
      ],
      "team": "string"
    }
  ]
}

Response fields

Field	Type	Description
event_id	uuid	The event.
name	string	The stat’s name.
stat	string	The stat key, as stat_detail.stat takes it.