List the people who obtained one badge

GET

/analytics/badges/{badgeConfigurationId}/holders

Analytics

Who obtained a badge, by name, with when they first obtained it. Searchable by nickname or email, sortable, paginated.

One row per person, however many times the badge was granted to them; people who have left the workspace are not listed. A badge with levels lists only the people who reached its last level. total counts every row matching the current search, so a client can say what an export covers.

A badge that is not this workspace's returns an empty list.

Request

Path Params

Query Params

Responses

🟢200OK

application/json

Badge holders retrieved successfully

Bodyapplication/json

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.aworld.cloud/dashboard/v1/analytics/badges//holders?limit=undefined&nextToken=undefined&order=undefined&q=undefined&sort=undefined'

Response Example

{
    "items": [
        {
            "userId": "string",
            "nickname": "string",
            "email": "string",
            "profileImage": "string",
            "firstAssignedAt": "string"
        }
    ],
    "total": 0,
    "nextToken": "string"
}

Modified at 2026-11-03 17:37:21

Check whether the workspace has any badge

Create multiple badge configuration tag assignments