# Leaderboards

## Get Leaderboard Standings

<mark style="color:blue;">`GET`</mark> `https://{organisation}.clearlrs.com/api/leaderboards`

Pulls leaderboard rankings for the specified leaderboard activity.

#### Query Parameters

| Name       | Type   | Description                                                            |
| ---------- | ------ | ---------------------------------------------------------------------- |
| activityId | string | The leaderboard activity to retrieve current standings.                |
| limit      | number | Sets the number of rankings that should be returned (defaults to `10`) |

{% tabs %}
{% tab title="200 Cake successfully retrieved." %}

```
{    "name": "Cake's name",    "recipe": "Cake's recipe name",    "cake": "Binary cake"}
```

{% endtab %}

{% tab title="404 Could not find a cake matching this query." %}

```
{    "message": "Ain't no cake like that."}
```

{% endtab %}
{% endtabs %}