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

# Leaderboards

## Create a leaderboard

<mark style="color:green;">`POST`</mark> `/v1/games/:game_id/leaderboards`

#### Path Parameters

| Name | Type   | Description |
| ---- | ------ | ----------- |
|      | string |             |

{% tabs %}
{% tab title="200 " %}

```
```

{% endtab %}
{% endtabs %}

## Retrieve a leaderboard

<mark style="color:blue;">`GET`</mark> `/v1/games/:game_id/leaderboards/:id`

#### Path Parameters

| Name | Type   | Description |
| ---- | ------ | ----------- |
|      | string |             |

{% tabs %}
{% tab title="200 " %}

```
```

{% endtab %}
{% endtabs %}

## Update a leaderboard

<mark style="color:orange;">`PUT`</mark> `/v1/games/:game_id/leaderboards/:id`

#### Path Parameters

| Name | Type   | Description |
| ---- | ------ | ----------- |
|      | string |             |

{% tabs %}
{% tab title="200 " %}

```
```

{% endtab %}
{% endtabs %}

## Delete a leaderboard

<mark style="color:red;">`DELETE`</mark> `/v1/games/:game_id/leaderboards/:id`

#### Path Parameters

| Name | Type   | Description |
| ---- | ------ | ----------- |
|      | string |             |

{% tabs %}
{% tab title="200 " %}

```
```

{% endtab %}
{% endtabs %}

## List all leaderboards

<mark style="color:blue;">`GET`</mark> `/v1/games/:game_id/leaderboards`

#### Path Parameters

| Name | Type   | Description |
| ---- | ------ | ----------- |
|      | string |             |

{% tabs %}
{% tab title="200 " %}

```
```

{% endtab %}
{% endtabs %}

## List a leaderboard's rankings

<mark style="color:blue;">`GET`</mark> `/v1/games/:game_id/leaderboards/:id/rankings`

#### Path Parameters

| Name | Type   | Description |
| ---- | ------ | ----------- |
|      | string |             |

{% tabs %}
{% tab title="200 " %}

```
```

{% endtab %}
{% endtabs %}

## List a specific player's leaderboard ranking

<mark style="color:blue;">`GET`</mark> `/v1/games/:game_id/leaderboards/:id/players/:player_id/rankings`

#### Path Parameters

| Name | Type   | Description |
| ---- | ------ | ----------- |
|      | string |             |

{% tabs %}
{% tab title="200 " %}

```
```

{% endtab %}
{% endtabs %}