---
title: "Get user's badge progress"
method: GET
path: "/users/{address}/badges"
tags: ["User Progress"]
---

# Get user's badge progress

`GET /users/{address}/badges`

Returns detailed progress information for all badges associated with a specific user address.

This endpoint provides comprehensive tracking data including:
- **Achieved badges**: Badges the user has earned (at least one step completed)
- **Progress tracking**: Current steps completed vs. target steps for next tier
- **Tier progression**: For tiered badges, shows which tiers have been completed and when
- **Completion status**: Whether the badge/tier is fully completed
- **Asset information**: Current badge/tier images and metadata

The response is divided into two categories:
- `achieved`: Badges with at least one step or tier completed
- `notAchieved`: Badges not yet started (only included if `includeNotAchieved=true`)

For tiered badges, the progress tracks movement through tiers (Starter → Bronze → Silver → Gold → Platinum → Diamond).
For single-tier badges, it tracks completion of a specific criteria.

## Path parameters

- `address` string, required

## Query parameters

- `includeNotAchieved` boolean

## Response `200`

Successfully retrieved user's badge progress

- object
  - `data` object — Container for user's badge progress, divided by achievement status
    - `achieved` object[], required — Badges with at least one step or tier completed
      - `id` string, required — Badge identifier
      - `name` string, required — Badge name
      - `description` string, required — Badge description
      - `category` 'Explorer' | 'Collector' | 'Creator' | 'Socializer' | 'Builder', required — Badge category
      - `isTier` boolean, required — Whether this badge has multiple tiers
      - `completedAt` number, nullable — Unix timestamp (milliseconds) when badge was fully completed, null if not completed
      - `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
      - `progress` object, required — Progress tracking information
        - `achievedTiers` object[] — List of tiers achieved (only for tiered badges)
          - `tierId` string
          - `completedAt` number — Unix timestamp (milliseconds) when tier was completed
        - `stepsDone` integer — Number of steps/actions completed
        - `nextStepsTarget` integer, nullable — Target steps for next tier/completion (null if fully completed)
        - `totalStepsTarget` integer — Total steps required for full badge completion
        - `lastCompletedTierAt` number, nullable — Timestamp of last completed tier (tiered badges only)
        - `lastCompletedTierName` string, nullable — Name of last completed tier (tiered badges only)
        - `lastCompletedTierImage` string, nullable — Image URL of last completed tier (tiered badges only)
    - `notAchieved` object[], required — Badges not yet started (only included if includeNotAchieved=true)
      - `id` string, required — Badge identifier
      - `name` string, required — Badge name
      - `description` string, required — Badge description
      - `category` 'Explorer' | 'Collector' | 'Creator' | 'Socializer' | 'Builder', required — Badge category
      - `isTier` boolean, required — Whether this badge has multiple tiers
      - `completedAt` number, nullable — Unix timestamp (milliseconds) when badge was fully completed, null if not completed
      - `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
      - `progress` object, required — Progress tracking information
        - `achievedTiers` object[] — List of tiers achieved (only for tiered badges)
          - `tierId` string
          - `completedAt` number — Unix timestamp (milliseconds) when tier was completed
        - `stepsDone` integer — Number of steps/actions completed
        - `nextStepsTarget` integer, nullable — Target steps for next tier/completion (null if fully completed)
        - `totalStepsTarget` integer — Total steps required for full badge completion
        - `lastCompletedTierAt` number, nullable — Timestamp of last completed tier (tiered badges only)
        - `lastCompletedTierName` string, nullable — Name of last completed tier (tiered badges only)
        - `lastCompletedTierImage` string, nullable — Image URL of last completed tier (tiered badges only)

## Other responses

- `404` — User address not found or invalid

---

[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)