> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coveapp.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Get leaderboard

> Time in game, most first.

> [!NOTE]
>
> Needs the `activity:read` permission on a workspace key.

**period** `string` (default: week)

One of `day`, `week`, `month` or `all`.

**limit** `integer` (default: 25)

How many entries to return, 1 to 100.

```bash cURL theme={null}
curl "https://api.coveapp.cc/v1/activity/leaderboard?period=week" \
  -H "Authorization: Bearer $COVE_API_KEY"
```

**data** `array`

Members ranked by time in game, most first.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.