---
title: "Gets a list of badges a user has been awarded."
method: GET
path: "/v1/users/{userId}/badges"
tags: ["Badges", "User profiles", "Users"]
---

# Gets a list of badges a user has been awarded.

`GET /v1/users/{userId}/badges`

## Path parameters

- `userId` integer, required

## Query parameters

- `limit` 10 | 25 | 50 | 100
- `cursor` string
- `sortOrder` 'Asc' | 'Desc'

## Response `200`

OK

- RobloxWebWebAPIModelsApiPageResponseRobloxBadgesApiGetBadgesByUserResponse
  - `previousPageCursor` string
  - `nextPageCursor` string
  - `data` RobloxBadgesApiGetBadgesByUserResponse[]
    - `creator` RobloxBadgesApiBadgeCreatorResponse — Represents information about the badge creator. (Creator of the place that awarded the badge)
      - `id` integer — The creator ID
      - `name` string — The name of the creator
      - `type` string — The type of the creator
    - `id` integer
    - `name` string
    - `description` string
    - `displayName` string
    - `displayDescription` string
    - `enabled` boolean
    - `iconImageId` integer
    - `displayIconImageId` integer
    - `awarder` RobloxWebResponsesRelatedEntityTypeResponseRobloxPlatformBadgesBadgeAwarderType
      - `id` integer
      - `type` 1 — ['Place' = 1]
      - `name` string
    - `statistics` RobloxWebResponsesBadgesBadgeAwardStatisticsResponse
      - `pastDayAwardedCount` integer
      - `awardedCount` integer
      - `winRatePercentage` number, double
    - `created` string, date-time
    - `updated` string, date-time

## Other responses

- `404` — 4: User is invalid or does not exist.

---

[API](https://skmtc.net/roblox/apis/roblox-api.md) · [All operations](https://skmtc.net/roblox/apis/roblox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/roblox/roblox-api/versions/756260310407/schema)