## XP leaderboard for a circle

**get** `/api/v1/circles/{id}/leaderboard`

Returns circle members ranked by XP descending.

### Path Parameters

- `id: string`

### Query Parameters

- `limit: optional number`

  Max results (1–100, default 25)

### Returns

- `entries: optional array of LeaderboardEntry`

  - `id: optional string`

  - `joinedAt: optional string`

  - `level: optional number`

  - `role: optional "OWNER" or "ADMIN" or "MEMBER"`

    - `"OWNER"`

    - `"ADMIN"`

    - `"MEMBER"`

### Example

```http
curl https://racks.cash/api/v1/circles/$ID/leaderboard
```

#### Response

```json
{
  "entries": [
    {
      "image": "image",
      "name": "Alice",
      "rank": 1,
      "streakDays": 12,
      "username": "alice",
      "xp": 9800,
      "id": "id",
      "joinedAt": "2019-12-27T18:11:19.117Z",
      "level": 0,
      "role": "OWNER"
    }
  ]
}
```