Match Discovery

List a team's matches

Returns matches for a specific team (resolved by id or slug), newest first, with cursor pagination. The authenticated user must be an active member of the team. Requires the matches.team_matches:read permission.

post/teams/{identifier}/matches

Path parameters

identifierstring required

Team id or slug.

Team id or slug.

Request body

numItemsinteger

Page size (1-100). Defaults to 25.

cursorstring nullable

Opaque continuation cursor from a prior page's continueCursor.

includeStatusesstring[]

Only include matches with these MatchStatus codes; unknown values are ignored.

excludeStatusesstring[]

Exclude matches with these MatchStatus codes; unknown values are ignored.

gameIdstring

Filter to a single game by id.

scheduledAfterstring

ISO 8601; only matches scheduled at or after this time.

scheduledBeforestring

ISO 8601; only matches scheduled at or before this time.

createdAfterstring

ISO 8601; only matches created at or after this time.

createdBeforestring

ISO 8601; only matches created at or before this time.

opponentIdstring

Filter to matches against this opponent team (team id or slug).

Response

Cursor-paginated result. continueCursor is non-null even when isDone is true.

isDoneboolean required
continueCursorstring required

Changes

Changed in 3 of the 21 revisions of this API.26

    • api tag Match Discovery added

      api-tag-added

    • api tag Matches removed

      api-tag-removed

    • added the optional property /////// to the response with the status

      response-optional-property-added

    • added the optional property /////// to the response with the status

      response-optional-property-added

    This revision also has 68 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • removed the optional property /////// from the response with the status

      response-optional-property-removed

    • removed the optional property /////// from the response with the status

      response-optional-property-removed

    • api tag Matches added

      api-tag-added

    • api tag Match Discovery removed

      api-tag-removed

    This revision also has 377 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog