---
search:
  tags:
    - Achievements
    - GET
seo:
  description: >-
    Returns every achievement definition: id, name, description, rarity, XP,
    category… Reference for the GET /achievements endpoint in the dartpilot
    Public API.
sidebar:
  label: Get the achievement catalog
  badge: GET
title: Get the achievement catalog
type: openapi-operation
---
Returns every achievement definition: id, name, description, rarity, XP, category and condition. This is static reference data with no per-player unlocks; use `/v1/players/{id}/achievements` for a player's unlocked list.

`GET /achievements`

**Responses**

- `200` — The achievement catalog.
- `400` — Invalid request.
- `401` — Missing or invalid API key.
- `403` — The API key is missing a required scope or is the wrong type for this endpoint.
- `404` — Entity not found.
- `429` — Rate limit exceeded. See the \`Retry-After\` header.
- `500` — Internal server error.

Response example, 200:

```json
{
  "catalog": [
    {
      "id": "string",
      "name": "string",
      "description": "string",
      "rarity": "common",
      "xp": 0,
      "category": "first_steps",
      "condition": {
        "property1": null,
        "property2": null
      },
      "sortOrder": -9007199254740991
    }
  ]
}
```