Player Percent to Play
Requires elevated access, inquire here.
Get player percent-to-play data for a specific league with cursor-based pagination. Returns 50 items per page.
Endpoint:
GET /player/{league}/percent-to-play
URL Parameters
|
Field |
Type |
Description |
|---|---|---|
|
|
string |
League identifier (e.g., "nfl", "nba", "mlb") |
Query Parameters
|
Field |
Type |
Description |
|---|---|---|
|
|
string |
Cursor for pagination (opaque base64-encoded string). Omit for first page. |
|
|
string |
Sort order: "desc" (default, newest first) or "asc" (oldest first) |
|
|
long |
Optional. Filter by specific player ID |
|
|
int |
Optional. Filter by specific team ID |
Response Fields
|
Field |
Type |
Description |
|---|---|---|
|
|
array |
Array of player percent-to-play items (see below) |
|
|
boolean |
Indicates whether the operation was successful |
|
|
array |
Collection of messages (errors, warnings, info) |
|
|
object |
Pagination information (see below) |
Pagination Object
|
Field |
Type |
Description |
|---|---|---|
|
|
string |
Cursor to use for fetching the next page. Empty string if no next page. |
|
|
string |
Cursor to use for fetching the previous page. Empty string if no previous page. |
Player Percent to Play Item Fields
|
Field |
Type |
Description |
|---|---|---|
|
|
int |
League identifier |
|
|
object |
Player information (see Person Fields below) |
|
|
object |
Event information (see Event Fields below) |
|
|
object |
Team information (see Team Fields below) |
|
|
decimal |
Percent chance the player will play in the next game (0-100) |
|
|
string |
Additional notes or description |
|
|
object |
Metadata about the item (see Meta Fields below) |
Person Fields
|
Field |
Type |
Description |
|---|---|---|
|
|
long |
Player identifier |
|
|
string |
Player first name |
|
|
string |
Player last name |
Event Fields
|
Field |
Type |
Description |
|---|---|---|
|
|
long |
Event identifier |
|
|
string |
Event name |
|
|
datetime |
Event start time (UTC) |
|
|
int |
Event status ID (1=PREGAME, 2=LIVE, 3=FINAL, etc.) |
Team Fields
|
Field |
Type |
Description |
|---|---|---|
|
|
long |
Team identifier |
|
|
string |
Team name |
Meta Fields
|
Field |
Type |
Description |
|---|---|---|
|
|
datetime |
Date the item was created (UTC) |
|
|
datetime |
Date the item was last updated (UTC) |
Pagination Example
To fetch the next page, use the
nextCursor
value from the response:
GET /player/nba/percent-to-play?cursor=eyJpZCI6MTIzNDUsImRpcmVjdGlvbiI6Im5leHQifQ==
Filtering Example
To fetch percent-to-play data for a specific player:
GET /player/nba/percent-to-play?personId=12345
To fetch percent-to-play data for a specific team:
GET /player/nba/percent-to-play?teamId=200