Skip to main content

League Tables

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

Updated today

League Tables

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

Field Definitions

Identification Fields

Field

Description

id

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

guid

Globally unique identifier (object, read-only)

slug

Alphanumeric identifier unique to its type

link

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

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)

Content Fields

Field

Description

title

The title for the league table object

content

The content for the league table object

excerpt

The excerpt for the league table object

Status and Access Fields

Field

Description

status

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

password

A password to protect access to the content and excerpt

comment_status

Whether or not comments are open; open or closed

ping_status

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

Media and Metadata Fields

Field

Description

author

The ID for the author of the object (integer)

featured_media

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

menu_order

The order of the object in relation to other objects of its type (integer)

Taxonomy Fields

Field

Description

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)

Table-Specific Fields

Field

Description

data

The full league table data including standings for all teams (array, read-only in view context)

The data field returns the calculated standings array, including all configured column values for each team in the table. This is a computed field and is not directly writable.

Example Requests

List All League Tables

GET /wp-json/sportspress/v2/tables

Retrieve a Single League Table

GET /wp-json/sportspress/v2/tables/20

The response includes the data array with the full standings.

Create a League Table

POST /wp-json/sportspress/v2/tables
Content-Type: application/json{
  "title": "Premier Division 2026",
  "status": "publish",
  "leagues": [5],
  "seasons": [3]
}

Did this answer your question?