---
title: "Get user score statistics"
method: GET
path: "/vocalize/2/scores/stats"
tags: ["customer-engagement", "vocalize", "score"]
---

# Get user score statistics

`GET /vocalize/2/scores/stats`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/vocalize/2/scores/stats`
- Auth: API key in header `Authorization`

This endpoint retrieves score statistics for a specific user in a campaign.

## Query parameters

- `campaignId` string, uuid, required: ID of the campaign to get score stats for.
- `userId` string, required: User ID, a unique identifier for the user.

## Response `200`

Score stats successfully retrieved

- 1e177a7c00f43fb0cfaf8876573312572061d384022066ddec32b06770199719ScoreStatsResponse
  - `position` integer: Position of the participant on the leaderboard, taking into account tie-breaking.
  - `rank` integer: Position of the participant on the leaderboard, not taking into account tie-breaking.
  - `tiedWith` integer: Number of other participants tied with the same score.
  - `bestScore` integer: The highest score achieved by the participant in the campaign.
  - `attempts` integer, required: Total number of attempts made by the participant in the campaign.
  - `attemptsRemaining` integer, required: Number of attempts remaining for the participant today.
  - `nextScoreToBeat` integer: The next highest score the participant needs to beat to improve their ranking.
  - `numberOfParticipants` integer: Total number of participants in the campaign.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)