Sign in
Match Discovery

List an organization's matches

Returns matches across all teams in an organization (resolved by id or slug), newest first, with cursor pagination. The authenticated user must be an active member of the organization. Requires the matches.org_matches:read permission.

post/orgs/{identifier}/matches

Path parameters

identifierstring required

Organization id or slug.

Organization 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

  • 82f2480cdb832See the full diff
    • ○

      api tag Match Discovery added

      api-tag-added

    • ○

      api tag Matches removed

      api-tag-removed

  • 480c7d480b2e2See the full diff
    • ○

      added the optional property page/items/acceptedTeam/anyOf[Team]/avatarUrl to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property page/items/creatorTeam/anyOf[Team]/avatarUrl to the response with the 200 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

  • f22bd61fd59522See the full diff
    • ●

      removed the optional property page/items/acceptedTeam/anyOf[Team]/avatarUrl from the response with the 200 status

      response-optional-property-removed

    • ●

      removed the optional property page/items/creatorTeam/anyOf[Team]/avatarUrl from the response with the 200 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