---
title: "Get Badge Definitions"
method: GET
path: "/gamification/definitions/badges"
tags: ["gamification"]
---

# Get Badge Definitions

`GET /gamification/definitions/badges`

Get all badge definitions or filter by category.

## Query parameters

- `category` 'exercises_completed' | 'chat_messages_sent' | 'exercises_rated_or_noted' | 'streak_days'

## Response `200`

Successful Response

- BadgeDefinitionResponse[]
  - `id` string, required
  - `category` 'exercises_completed' | 'chat_messages_sent' | 'exercises_rated_or_noted' | 'streak_days', required
  - `tier` integer, required
  - `name` string, required
  - `description` string, required
  - `threshold` integer, required
  - `xp_reward` integer, required
  - `image_url` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) · [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/excellence-ai/excellence-learning/revisions/8d495ed916c6/schema)