For the complete documentation index, see llms.txt. This page is also available as Markdown.

Progress

User progress tracking and goals

Get user progress

get
/users/{address}/progress

Returns comprehensive progress information for a specific user including season status, current week, goals progress, available credits, and enrollment status. Requires signed fetch authentication.

Authorizations
AuthorizationstringRequired

Signed fetch authentication using @dcl/platform-crypto-middleware (ADR-44l). Requires auth chain headers (x-identity, x-signature, x-timestamp) for signature validation. See http://adr.decentraland.org/adr/ADR-44l for details.

Path parameters
addressstringRequired

User's Ethereum address

Example: 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEbPattern: ^0x[a-fA-F0-9]{40}$
Responses
200

User progress retrieved successfully

application/json
get/users/{address}/progress
GET /users/{address}/progress HTTP/1.1
Host: credits.decentraland.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "season": {
    "timeLeft": 1,
    "startDate": "2026-01-01T00:00:00.000Z",
    "endDate": "2026-01-01T00:00:00.000Z",
    "seasonState": "NOT_STARTED"
  },
  "currentWeek": {
    "timeLeft": 1
  },
  "user": {
    "hasStartedProgram": true
  },
  "credits": {
    "available": 1,
    "expiresIn": 1,
    "isBlockedForClaiming": true
  },
  "goals": [
    {
      "id": "text",
      "title": "text",
      "description": "text",
      "thumbnail": "text",
      "progress": {
        "totalSteps": 1,
        "completedSteps": 1
      },
      "reward": 1,
      "isClaimed": true
    }
  ]
}

Last updated