> For the complete documentation index, see [llms.txt](https://docs.terragon.io/documents/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.terragon.io/documents/terragon-api-document/tournament.md).

# Tournament

Game tournaments

## List active tournaments

> Retrieve a list of currently active tournaments

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"Tournament","description":"Game tournaments"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PaginationMeta":{"type":"object","properties":{"current_page":{"type":"integer","description":"Current page number"},"last_page":{"type":"integer","description":"Last page number"},"per_page":{"type":"integer","description":"Number of items per page"},"total":{"type":"integer","description":"Total number of items"},"data":{"type":"array","description":"Collection of items for the current page","items":{"type":"object"}}}},"Error":{"type":"object","properties":{"message":{"type":"string","description":"Error message"}}}}},"paths":{"/v1/tournaments":{"get":{"tags":["Tournament"],"summary":"List active tournaments","description":"Retrieve a list of currently active tournaments","operationId":"listTournaments","parameters":[{"name":"page","in":"query","required":false,"description":"Page number for pagination","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","required":false,"description":"Number of items per page","schema":{"type":"integer","default":10}},{"name":"game_type","in":"query","required":false,"description":"Filter by game type","schema":{"type":"string"}}],"responses":{"200":{"description":"Tournaments retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginationMeta"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## List past tournaments

> Retrieve a list of completed tournaments

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"Tournament","description":"Game tournaments"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PaginationMeta":{"type":"object","properties":{"current_page":{"type":"integer","description":"Current page number"},"last_page":{"type":"integer","description":"Last page number"},"per_page":{"type":"integer","description":"Number of items per page"},"total":{"type":"integer","description":"Total number of items"},"data":{"type":"array","description":"Collection of items for the current page","items":{"type":"object"}}}},"Error":{"type":"object","properties":{"message":{"type":"string","description":"Error message"}}}}},"paths":{"/v1/tournaments/past":{"get":{"tags":["Tournament"],"summary":"List past tournaments","description":"Retrieve a list of completed tournaments","operationId":"listPastTournaments","parameters":[{"name":"page","in":"query","required":false,"description":"Page number for pagination","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","required":false,"description":"Number of items per page","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Past tournaments retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginationMeta"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Get tournament details

> Retrieve details of a specific tournament

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"Tournament","description":"Game tournaments"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"Tournament":{"type":"object","properties":{"id":{"type":"integer","description":"Tournament ID"},"name":{"type":"string","description":"Tournament name"},"game_type":{"type":"string","description":"Game type"},"start_date":{"type":"string","format":"date-time","description":"Tournament start date"},"end_date":{"type":"string","format":"date-time","description":"Tournament end date"},"is_active":{"type":"boolean","description":"Whether the tournament is active"},"created_at":{"type":"string","format":"date-time","description":"Tournament creation timestamp"}}},"Error":{"type":"object","properties":{"message":{"type":"string","description":"Error message"}}}}},"paths":{"/v1/tournaments/{id}":{"get":{"tags":["Tournament"],"summary":"Get tournament details","description":"Retrieve details of a specific tournament","operationId":"getTournamentDetails","parameters":[{"name":"id","in":"path","required":true,"description":"Tournament ID","schema":{"type":"integer"}}],"responses":{"200":{"description":"Tournament details retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Tournament"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Tournament not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Register for tournament

> Register the player for a specific tournament

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"Tournament","description":"Game tournaments"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"TournamentRegistration":{"type":"object","properties":{"id":{"type":"integer","description":"Registration ID"},"player_id":{"type":"integer","description":"Player ID"},"tournament_id":{"type":"integer","description":"Tournament ID"},"status":{"type":"string","enum":["pending","approved","rejected"],"description":"Registration status"},"created_at":{"type":"string","format":"date-time","description":"Registration creation timestamp"}}},"Error":{"type":"object","properties":{"message":{"type":"string","description":"Error message"}}}}},"paths":{"/v1/tournaments/{id}/register":{"post":{"tags":["Tournament"],"summary":"Register for tournament","description":"Register the player for a specific tournament","operationId":"registerForTournament","parameters":[{"name":"id","in":"path","required":true,"description":"Tournament ID","schema":{"type":"integer"}}],"responses":{"200":{"description":"Tournament registration successful","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TournamentRegistration"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Tournament not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Unable to register for tournament","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Tournament leaderboard

> Retrieve the current leaderboard for a tournament

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"Tournament","description":"Game tournaments"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PaginationMeta":{"type":"object","properties":{"current_page":{"type":"integer","description":"Current page number"},"last_page":{"type":"integer","description":"Last page number"},"per_page":{"type":"integer","description":"Number of items per page"},"total":{"type":"integer","description":"Total number of items"},"data":{"type":"array","description":"Collection of items for the current page","items":{"type":"object"}}}},"Error":{"type":"object","properties":{"message":{"type":"string","description":"Error message"}}}}},"paths":{"/v1/tournaments/{id}/leaderboard":{"get":{"tags":["Tournament"],"summary":"Tournament leaderboard","description":"Retrieve the current leaderboard for a tournament","operationId":"getTournamentLeaderboard","parameters":[{"name":"id","in":"path","required":true,"description":"Tournament ID","schema":{"type":"integer"}},{"name":"page","in":"query","required":false,"description":"Page number for pagination","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","required":false,"description":"Number of items per page","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Tournament leaderboard retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginationMeta"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Tournament not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Tournament rewards

> Retrieve a list of tournament rewards won by the player

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"Tournament","description":"Game tournaments"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"PaginationMeta":{"type":"object","properties":{"current_page":{"type":"integer","description":"Current page number"},"last_page":{"type":"integer","description":"Last page number"},"per_page":{"type":"integer","description":"Number of items per page"},"total":{"type":"integer","description":"Total number of items"},"data":{"type":"array","description":"Collection of items for the current page","items":{"type":"object"}}}},"Error":{"type":"object","properties":{"message":{"type":"string","description":"Error message"}}}}},"paths":{"/v1/tournaments/rewards":{"get":{"tags":["Tournament"],"summary":"Tournament rewards","description":"Retrieve a list of tournament rewards won by the player","operationId":"getTournamentRewards","parameters":[{"name":"page","in":"query","required":false,"description":"Page number for pagination","schema":{"type":"integer","default":1}},{"name":"per_page","in":"query","required":false,"description":"Number of items per page","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Tournament rewards retrieved successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaginationMeta"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```

## Get past tournaments

> Retrieve list of past tournaments

```json
{"openapi":"3.0.0","info":{"title":"Terragon API Document","version":"1.0.0"},"tags":[{"name":"Tournament","description":"Game tournaments"}],"servers":[{"url":"https://api.terragon.io/player/api","description":"Staging server"}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"Tournament":{"type":"object","properties":{"id":{"type":"integer","description":"Tournament ID"},"name":{"type":"string","description":"Tournament name"},"game_type":{"type":"string","description":"Game type"},"start_date":{"type":"string","format":"date-time","description":"Tournament start date"},"end_date":{"type":"string","format":"date-time","description":"Tournament end date"},"is_active":{"type":"boolean","description":"Whether the tournament is active"},"created_at":{"type":"string","format":"date-time","description":"Tournament creation timestamp"}}}}},"paths":{"/v1/past-tournaments":{"get":{"tags":["Tournament"],"summary":"Get past tournaments","description":"Retrieve list of past tournaments","operationId":"getPastTournaments","responses":{"200":{"description":"Past tournaments retrieved successfully","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Tournament"}}}}}}}}}}
```