Player Lists
Endpoint: /wp-json/sportspress/v2/lists
Field Definitions
Identification Fields
Field | Description |
| Unique identifier for the object (integer, read-only) |
| Globally unique identifier (read-only) |
| URL to the object (string URI, read-only) |
| Alphanumeric identifier unique to its type |
Date and Time Fields
Field | Description |
| Publication date in site timezone (ISO 8601 datetime) |
| Publication date as GMT (ISO 8601 datetime) |
| Last modification date in site timezone (ISO 8601 datetime, read-only) |
| Last modification date as GMT (ISO 8601 datetime, read-only) |
Status and Access Fields
Field | Description |
| Named status for the object; one of |
| The ID for the author of the object (integer) |
| A password to protect access to the content and excerpt |
Content Fields
Field | Description |
| The title for the player list object |
| The content for the player list object |
| The excerpt for the player list object |
Media and Engagement Fields
Field | Description |
| The ID of the featured media for the object (integer) |
| Whether or not comments are open; |
| Whether or not the object can be pinged; |
List-Specific Fields
Field | Description |
| The display format; one of |
| The terms assigned to the object in the league taxonomy (array of term IDs) |
| The terms assigned to the object in the season taxonomy (array of term IDs) |
| The terms assigned to the object in the position taxonomy (array of term IDs) |
| The full player list data including all players and their statistics (array, read-only) |
The data field returns the computed player list with all configured column values. This field is computed from the assigned league/season/team configuration and is not directly writable.
Example Requests
List All Player Lists
GET /wp-json/sportspress/v2/lists
Retrieve a Single Player List
GET /wp-json/sportspress/v2/lists/30
The response includes the data array with all players and their statistics columns.
Create a Player List
POST /wp-json/sportspress/v2/lists
Content-Type: application/json{
"title": "Top Scorers 2026",
"status": "publish",
"format": "list",
"leagues": [5],
"seasons": [3]
}
