# Get my leaderboard standing

```http
GET /api/public/v1/competitions/{competitionId}/leaderboard/me
```

**Scope**: `competition.read`.

Returns the calling account's current public leaderboard entry. The current backend returns a populated entry only for a published IGP24 leaderboard; other competitions return `entry: null`.

## Path parameters

| Parameter | Type | Required | Description |
| :--- | :--- | :---: | :--- |
| `competitionId` | string | Yes | Competition ID. |

## Response DTO

```ts
type GetMyLeaderboardStandingResponse = {
  ok: true;
  data: {
    entry: {
      rank: number;
      teamId: string;
      teamNumber: string | null;
      teamName: string;
      score: number;
      scoreablePairs: number;
    } | null;
  };
};
```

## IGP24 example

```bash
curl "https://api.sair.foundation/api/public/v1/competitions/igp24/leaderboard/me" \
  -H "Authorization: Bearer $SAIR_API_KEY"
```

```json
{
  "ok": true,
  "data": {
    "entry": {
      "rank": 7,
      "teamId": "teamv2_a7a863ce80e6447881ad068bab82498e",
      "teamNumber": "IGP24-T00007",
      "teamName": "Galois Wranglers",
      "score": 4.7321,
      "scoreablePairs": 12
    }
  }
}
```

## Null example

This complete response applies when the leaderboard is unpublished, the caller has no eligible team, the team has no scoring placement, or the competition is not IGP24.

For the three non-IGP24 competitions, the concrete requests are:

```bash
curl "https://api.sair.foundation/api/public/v1/competitions/modular-arithmetic-challenge/leaderboard/me" \
  -H "Authorization: Bearer $SAIR_API_KEY"

curl "https://api.sair.foundation/api/public/v1/competitions/mathematics-distillation-challenge-equational-theories-stage1/leaderboard/me" \
  -H "Authorization: Bearer $SAIR_API_KEY"

curl "https://api.sair.foundation/api/public/v1/competitions/mathematics-distillation-challenge-equational-theories-stage2/leaderboard/me" \
  -H "Authorization: Bearer $SAIR_API_KEY"
```

```json
{
  "ok": true,
  "data": {
    "entry": null
  }
}
```

## Errors

See [Errors](../../../errors.md) for common authentication, scope, not-found, and rate-limit errors.
