---
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`

## Request

- Base URL: `https://badges.roblox.com`
- URL: `https://badges.roblox.com/v1/users/{userId}/badges`
- Auth: API key in cookie `.ROBLOSECURITY`

Respects inventory privacy settings when evaluating which awarded badges are visible.

## 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.

## Changes

- **2026-10-14** `5dcfa33df56a`: 1 info
  - endpoint added
- **2026-08-12** `80880b69892d`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/roblox/apis/roblox-api/changes/v1/users/:userId/badges/get.md)

---

[API](https://skmtc.dev/roblox/apis/roblox-api.md) - [All operations](https://skmtc.dev/roblox/apis/roblox-api/llms.txt) - [OpenAPI document](https://skmtc.dev/roblox/apis/roblox-api/revisions/bcfdc20689cd?raw)