---
title: "Query multiple matches"
method: GET
path: "/v3/matches"
tags: ["Match"]
---

# Query multiple matches

`GET /v3/matches`

## Request

- Base URL: `https://api.statbotics.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.statbotics.io/v3/matches`
- Auth: none declared

Returns up to 1000 matches at a time. Specify limit and offset to page through results.

## Query parameters

- `team` integer, nullable: Team number (no prefix), e.g. 5511.
- `year` integer, nullable: Four-digit year
- `event` string, nullable: Event key, e.g. `2019ncwak`.
- `week` integer, nullable: Week of the competition season. 8 is CMP
- `elim` boolean, nullable: Whether the match is an elimination match.
- `metric` string, nullable: How to sort the returned values. Any column in the table is valid.
- `ascending` boolean, nullable: Whether to sort the returned values in ascending order. Default is ascending
- `limit` integer, nullable: Maximum number of events to return. Default is 1000.
- `offset` integer, nullable: Offset from the first result to return.

## Response `200`

Successful Response

- object[]

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/statbotics/apis/statbotics-rest-api.md) · [All operations](https://skmtc.dev/statbotics/apis/statbotics-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/statbotics/apis/statbotics-rest-api/revisions/7b24722146a3?raw)