---
title: "List all badge definitions"
method: GET
path: "/badges"
tags: ["Badges"]
---

# List all badge definitions

`GET /badges`

Returns a complete catalog of all badge definitions available in Decentraland.

This endpoint returns badge metadata including:
- Badge identifiers, names, and descriptions
- Category classification (Explorer, Collector, Creator, Socializer, Builder)
- Completion criteria and tier configurations
- Asset URLs for badge images (2D and 3D)

Note: This endpoint returns badge definitions only, not user progress. To get user-specific progress, use the `/users/{address}/badges` endpoint.

## Response `200`

Successfully retrieved all badge definitions

- object
  - `data` object[]
    - `id` string, required — Unique badge identifier
    - `name` string, required — Human-readable badge name
    - `description` string, required — Detailed description of the badge and how to earn it
    - `category` 'Explorer' | 'Collector' | 'Creator' | 'Socializer' | 'Builder', required — Category classification for the badge
    - `criteria` object — Badge completion criteria (for non-tiered badges)
      - `steps` integer — Number of steps/actions required to complete the badge
    - `tiers` object[] — Progressive tier definitions (only present for tiered badges)
      - `tierId` string, required — Unique tier identifier (format: badgeName-tierLevel)
      - `tierName` 'Starter' | 'Bronze' | 'Silver' | 'Gold' | 'Platinum' | 'Diamond', required — Human-readable tier name
      - `description` string, required — Specific requirements to achieve this tier
      - `criteria` object — Tier completion criteria
        - `steps` integer — Number of steps/actions required to achieve this tier
      - `assets` object — Asset URLs for badge imagery in different formats
        - `2d` object — 2D badge assets
          - `normal` string, required — Standard 2D badge image URL
        - `3d` object — 3D badge assets for rendering in-world
          - `normal` string, required — 3D model file URL
          - `hrm` string, required — Height/roughness/metallic texture map URL
          - `basecolor` string, required — Base color texture map URL
    - `assets` object — Asset URLs for badge imagery in different formats
      - `2d` object — 2D badge assets
        - `normal` string, required — Standard 2D badge image URL
      - `3d` object — 3D badge assets for rendering in-world
        - `normal` string, required — 3D model file URL
        - `hrm` string, required — Height/roughness/metallic texture map URL
        - `basecolor` string, required — Base color texture map URL

## Other responses

- `400` — Bad request
- `500` — Internal server error

---

[API](https://skmtc.net/decentraland/apis/realm-provider-api.md) · [All operations](https://skmtc.net/decentraland/apis/realm-provider-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/decentraland/realm-provider-api/revisions/d94e0e0f1821/schema)