Skip to main content

Player Lists

**Endpoint:** `/wp-json/sportspress/v2/lists`

Updated today

Player Lists

Endpoint: /wp-json/sportspress/v2/lists

Field Definitions

Identification Fields

Field

Description

id

Unique identifier for the object (integer, read-only)

guid

Globally unique identifier (read-only)

link

URL to the object (string URI, read-only)

slug

Alphanumeric identifier unique to its type

Date and Time Fields

Field

Description

date

Publication date in site timezone (ISO 8601 datetime)

date_gmt

Publication date as GMT (ISO 8601 datetime)

modified

Last modification date in site timezone (ISO 8601 datetime, read-only)

modified_gmt

Last modification date as GMT (ISO 8601 datetime, read-only)

Status and Access Fields

Field

Description

status

Named status for the object; one of publish, future, draft, pending, or private

author

The ID for the author of the object (integer)

password

A password to protect access to the content and excerpt

Content Fields

Field

Description

title

The title for the player list object

content

The content for the player list object

excerpt

The excerpt for the player list object

Media and Engagement Fields

Field

Description

featured_media

The ID of the featured media for the object (integer)

comment_status

Whether or not comments are open; open or closed

ping_status

Whether or not the object can be pinged; open or closed

List-Specific Fields

Field

Description

format

The display format; one of list or gallery

leagues

The terms assigned to the object in the league taxonomy (array of term IDs)

seasons

The terms assigned to the object in the season taxonomy (array of term IDs)

positions

The terms assigned to the object in the position taxonomy (array of term IDs)

data

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]
}

Did this answer your question?