Badges

Operations for retrieving badge definitions, details, and tier information

List all badge definitions

get

https://badges.decentraland.orghttps://badges.decentraland.zone

/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.

Responses

200

Successfully retrieved all badge definitions

application/json

400

Bad request

application/json

500

Internal server error

application/json

get

/badges

HTTPcURLJavaScriptPython

GET /badges HTTP/1.1
Host: badges.decentraland.org
Accept: */*

{
  "data": [
    {
      "id": "traveler",
      "name": "Traveler",
      "description": "Explore Genesis City scenes for at least 1 minute each. Progress through tiers from 1 scene (Starter) to 10,000 scenes (Diamond).",
      "category": "Explorer",
      "criteria": {
        "steps": 1,
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "tiers": [
        {
          "tierId": "traveler-bronze",
          "tierName": "Bronze",
          "description": "50 Genesis City scenes explored (for at least 1 min)",
          "criteria": {
            "steps": 50,
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "assets": {
            "2d": {
              "normal": "https://badges.decentraland.org/assets/badge-2d.png"
            },
            "3d": {
              "normal": "text",
              "hrm": "text",
              "basecolor": "text"
            }
          }
        }
      ],
      "assets": {
        "2d": {
          "normal": "https://badges.decentraland.org/assets/badge-2d.png"
        },
        "3d": {
          "normal": "text",
          "hrm": "text",
          "basecolor": "text"
        }
      }
    }
  ]
}

Get specific badge details

get

https://badges.decentraland.orghttps://badges.decentraland.zone

/badges/{id}

Returns detailed information about a specific badge by its ID.

This endpoint provides the complete badge definition including:

• Badge name, description, and category

• Completion criteria (number of steps required)

• Tier definitions (if the badge has progressive tiers)

• 2D and 3D asset URLs for rendering the badge

Example badge IDs: dclcitizen, traveler, fashionista, emote_creator

Path parameters

idstringRequired

Unique badge identifier (e.g., 'dclcitizen', 'traveler', 'fashionista')

Example: traveler

Responses

200

Successfully retrieved badge details

application/json

404

Badge with the specified ID was not found

application/json

get

/badges/{id}

HTTPcURLJavaScriptPython

GET /badges/{id} HTTP/1.1
Host: badges.decentraland.org
Accept: */*

{
  "data": {
    "badge": {
      "id": "traveler",
      "name": "Traveler",
      "description": "Explore Genesis City scenes for at least 1 minute each. Progress through tiers from 1 scene (Starter) to 10,000 scenes (Diamond).",
      "category": "Explorer",
      "criteria": {
        "steps": 1,
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "tiers": [
        {
          "tierId": "traveler-bronze",
          "tierName": "Bronze",
          "description": "50 Genesis City scenes explored (for at least 1 min)",
          "criteria": {
            "steps": 50,
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "assets": {
            "2d": {
              "normal": "https://badges.decentraland.org/assets/badge-2d.png"
            },
            "3d": {
              "normal": "text",
              "hrm": "text",
              "basecolor": "text"
            }
          }
        }
      ],
      "assets": {
        "2d": {
          "normal": "https://badges.decentraland.org/assets/badge-2d.png"
        },
        "3d": {
          "normal": "text",
          "hrm": "text",
          "basecolor": "text"
        }
      }
    }
  }
}

Get badge tier progression

get

https://badges.decentraland.orghttps://badges.decentraland.zone

/badges/{id}/tiers

Returns the tier progression system for a specific badge.

Many badges in Decentraland have progressive tiers that users can unlock by achieving higher milestones:

• Starter: Initial tier, easiest to achieve

• Bronze: Second tier, moderate difficulty

• Silver: Third tier, increasing challenge

• Gold: Fourth tier, significant achievement

• Platinum: Fifth tier, major accomplishment

• Diamond: Sixth tier, highest achievement

Each tier has its own:

• Criteria/requirements (e.g., "Visit 50 scenes" for Bronze, "Visit 250 scenes" for Silver)

• Unique badge assets and imagery

• Tier-specific descriptions

Badges without tiers return an empty array.

Path parameters

idstringRequired

Badge identifier

Example: traveler

Responses

200

Successfully retrieved badge tiers (may be empty for non-tiered badges)

application/json

404

Badge with the specified ID was not found

application/json

get

/badges/{id}/tiers

HTTPcURLJavaScriptPython

GET /badges/{id}/tiers HTTP/1.1
Host: badges.decentraland.org
Accept: */*

{
  "data": {
    "tiers": [
      {
        "tierId": "traveler-bronze",
        "tierName": "Bronze",
        "description": "50 Genesis City scenes explored (for at least 1 min)",
        "criteria": {
          "steps": 50,
          "ANY_ADDITIONAL_PROPERTY": "anything"
        },
        "assets": {
          "2d": {
            "normal": "https://badges.decentraland.org/assets/badge-2d.png"
          },
          "3d": {
            "normal": "text",
            "hrm": "text",
            "basecolor": "text"
          }
        }
      }
    ]
  }
}