---
title: User Scores & Progress
url: https://docs.kaltura.com/docs/events-collaboration/gamification-api/gamification-user-scores-progress
---

## User Scores & Progress

### 10.1 Get User Score

**Parameters**

| Parameter | Type | Required | Description |
|---|---|---|---|
| `gameObjectId` | string | Yes | ID of the leaderboard, badge, certificate, or lead scoring profile |
| `userId` | string | Yes | Kaltura user ID to look up |

```bash
curl -X POST "$KALTURA_SCM_URL/userScore/get" \
  -H "Authorization: Bearer $KALTURA_KS" \
  -H "Content-Type: application/json" \
  -d '{"gameObjectId": "'$LEADERBOARD_ID'", "userId": "'$USER_ID'"}'
```

### 10.2 List Scores (Paginated Ranking)

```bash
curl -X POST "$KALTURA_SCM_URL/userScore/list" \
  -H "Authorization: Bearer $KALTURA_KS" \
  -H "Content-Type: application/json" \
  -d '{"gameObjectId": "'$LEADERBOARD_ID'", "pager": {"pageSize": 25, "pageIndex": 1}}'
```

### 10.3 Per-Rule Progress

```bash
curl -X POST "$KALTURA_SCM_URL/userScore/ruleProgress" \
  -H "Authorization: Bearer $KALTURA_KS" \
  -H "Content-Type: application/json" \
  -d '{"gameObjectId": "'$LEADERBOARD_ID'", "userId": "'$USER_ID'"}'
```

### 10.4 Clear Scores

**Parameters**

| Parameter | Type | Required | Description |
|---|---|---|---|
| `gameObjectId` | string | Yes | ID of the leaderboard whose scores should be cleared. Removes all user scores for this leaderboard |

```bash
curl -X POST "$KALTURA_SCM_URL/userScore/clear" \
  -H "Authorization: Bearer $KALTURA_KS" \
  -H "Content-Type: application/json" \
  -d '{"gameObjectId": "'$LEADERBOARD_ID'"}'
```

### 10.5 API v3 Game Plugin

User scores are also accessible via the standard Kaltura API v3:

```bash
curl -X POST "$KALTURA_SERVICE_URL/service/leaderboard_userscore/action/list" \
  -d "ks=$KALTURA_KS" \
  -d "format=1" \
  -d "filter[objectType]=KalturaUserScorePropertiesFilter" \
  -d "filter[gameObjectType]=1" \
  -d "filter[gameObjectId]=$LEADERBOARD_ID" \
  -d "pager[pageSize]=25" \
  -d "pager[pageIndex]=1"
```

Response: `KalturaUserScorePropertiesResponse` with `rank`, `userId`, `puserId`, `score`, `scoreTags`, `oldRank`.