Calendars
Endpoint: /wp-json/sportspress/v2/calendars
Field Definitions
Date and Time Fields
Field | Description |
| Publication date in site timezone (ISO 8601 format) |
| Publication date as GMT (ISO 8601 format) |
| Last modification date in site timezone (read-only) |
| Last modification date as GMT (read-only) |
Identification Fields
Field | Description |
| Unique numerical identifier for the object (read-only) |
| Globally unique identifier (read-only) |
| Alphanumeric identifier unique to its type |
| URL to the object (read-only) |
Content Fields
Field | Description |
| The title for the calendar object |
| The content for the calendar object |
| The excerpt for the calendar object |
| The ID for the author of the object |
| The ID of the featured media for the object |
Status and Access Fields
Field | Description |
| Named status for the object; one of |
| A password to protect access to the content and excerpt |
| Whether or not comments are open; |
| Whether or not the object can be pinged; |
Calendar-Specific Fields
Field | Description |
| 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 venue taxonomy (array of term IDs) |
| The full calendar event objects (array, |
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]
}
