# 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 %}