---
title: "Get Achievements"
method: GET
path: "/v1/achievements"
tags: ["Achievements"]
---

# Get Achievements

`GET /v1/achievements`

Returns a list of achievements.

## Query parameters

- `limit` integer — A limit on the number of objects to be returned
- `offset` integer — The number of objects to skip

## Response `200`

Successful Response

- AchievementRead[]
  - `name` string, required — The name of the achievement
  - `description` string, required — The description of the achievement
  - `image_url` string, uri, required — The URL of the image for the achievement
  - `type` union, required — The type of the achievement
    - 'first_visit' | 'first_purchase' | 'regular_visit'
    - string
  - `position` integer, required — The position of the achievement in the list
  - `id` string, required — The unique identifier of the achievement

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-18** `fb9750c99d0a` — 3 warning
  - for the `query` request parameter `limit`, the exclusiveMinimum was set to `1.00`
  - for the `query` request parameter `limit`, the max was set to `300.00`
  - for the `query` request parameter `offset`, the min was set to `0.00`

[Change history](https://skmtc.dev/aghanim/apis/aghanim-server-to-server-api/changes/v1/achievements/get.md)

---

[API](https://skmtc.dev/aghanim/apis/aghanim-server-to-server-api.md) · [All operations](https://skmtc.dev/aghanim/apis/aghanim-server-to-server-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aghanim/apis/aghanim-server-to-server-api/revisions/32e27bc547ae?raw)