Skip to main content

Calendars

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

Updated today

Calendars

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

Field Definitions

Date and Time Fields

Field

Description

date

Publication date in site timezone (ISO 8601 format)

date_gmt

Publication date as GMT (ISO 8601 format)

modified

Last modification date in site timezone (read-only)

modified_gmt

Last modification date as GMT (read-only)

Identification Fields

Field

Description

id

Unique numerical identifier for the object (read-only)

guid

Globally unique identifier (read-only)

slug

Alphanumeric identifier unique to its type

link

URL to the object (read-only)

Content Fields

Field

Description

title

The title for the calendar object

content

The content for the calendar object

excerpt

The excerpt for the calendar object

author

The ID for the author of the object

featured_media

The ID of the featured media for the 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

Calendar-Specific Fields

Field

Description

format

Display format; one of calendar, list, or blocks

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)

venues

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

data

The full calendar event objects (array, view context only)

The data field returns the full event objects for all events included in the calendar. This field is only present in the view context response and is not writable.

Example Requests

List All Calendars

GET /wp-json/sportspress/v2/calendars

Retrieve a Single Calendar with Event Data

GET /wp-json/sportspress/v2/calendars/45

The response includes the data array containing the full event objects for that calendar.

Create a Calendar

POST /wp-json/sportspress/v2/calendars
Content-Type: application/json{
  "title": "2026 Season Schedule",
  "status": "publish",
  "format": "list",
  "leagues": [5],
  "seasons": [3]
}

Did this answer your question?