Events
Endpoint: /wp-json/sportspress/v2/events
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 identifier for the object (integer, 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 event object |
| The content for the event object |
| The excerpt for the event object |
| 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; |
Author and Order Fields
Field | Description |
| The ID for the author of the object |
| The order of the object in relation to other objects of its type |
Taxonomy and Relationship Fields
Field | Description |
| 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 IDs of the teams participating in the event (array) |
| The IDs of the players participating in the event (array) |
| The IDs of the staff members participating in the event (array) |
Event-Specific Fields
Field | Description |
| The main results of the event (array, one value per team) |
| The outcome of the event per team (array) |
| The ID of the winning team |
| The full time of the event in minutes (integer) |
| The full results table for the event, per team (array) |
| The full performance (box score) table for the event, per team (array) |
All fields specify context availability (view, edit, embed). Fields marked as read-only cannot be set in POST or PUT requests.
Example Requests
List All Events
GET /wp-json/sportspress/v2/events
Retrieve a Single Event
GET /wp-json/sportspress/v2/events/123
Create an Event
POST /wp-json/sportspress/v2/events
Content-Type: application/json{
"title": "Team A vs Team B",
"status": "publish",
"date": "2026-05-01T15:00:00",
"teams": [10, 11],
"leagues": [5],
"seasons": [3]
}Update Event Results
PUT /wp-json/sportspress/v2/events/123
Content-Type: application/json{
"results": {
"10": { "goals": 2 },
"11": { "goals": 1 }
},
"performance": {
"10": {
"42": { "goals": 1, "assists": 0 }
}
}
}Note: Updating results and player performance via REST API requires SportsPress Pro 2.7.8 or later (earlier versions had a bug where results and box scores were not updating via API).
