Skip to main content

Events

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

Updated today

Events

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

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 identifier for the object (integer, 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 event object

content

The content for the event object

excerpt

The excerpt for the event object

featured_media

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

Author and Order Fields

Field

Description

author

The ID for the author of the object

menu_order

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

Taxonomy and Relationship 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)

venues

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

teams

The IDs of the teams participating in the event (array)

players

The IDs of the players participating in the event (array)

staff

The IDs of the staff members participating in the event (array)

Event-Specific Fields

Field

Description

main_results

The main results of the event (array, one value per team)

outcome

The outcome of the event per team (array)

winner

The ID of the winning team

minutes

The full time of the event in minutes (integer)

results

The full results table for the event, per team (array)

performance

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).

Did this answer your question?