---
title: "Gets badges by their awarding game."
method: GET
path: "/v1/universes/{universeId}/badges"
tags: ["Badges", "Universes"]
---

# Gets badges by their awarding game.

`GET /v1/universes/{universeId}/badges`

## Path parameters

- `universeId` integer, required

## Query parameters

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

## Response `200`

OK

- RobloxWebWebAPIModelsApiPageResponseRobloxBadgesApiBadgeResponse
  - `previousPageCursor` string
  - `nextPageCursor` string
  - `data` RobloxBadgesApiBadgeResponse[]
    - `id` integer — The badge Id.
    - `name` string — The name of the badge.
    - `description` string — The badge description.
    - `displayName` string — The localized name of the badge.
    - `displayDescription` string — The localized badge description.
    - `enabled` boolean — Whether or not the badge is enabled.
    - `iconImageId` integer — The badge icon asset Id.
    - `displayIconImageId` integer — The localized badge icon asset Id.
    - `created` string, date-time — When the badge was created.
    - `updated` string, date-time — When the badge was updated.
    - `statistics` RobloxWebResponsesBadgesBadgeAwardStatisticsResponse
      - `pastDayAwardedCount` integer
      - `awardedCount` integer
      - `winRatePercentage` number, double
    - `awardingUniverse` RobloxBadgesApiUniverseResponse — A response containing universe information.
      - `id` integer — The universe Id.
      - `name` string — The universe name.
      - `rootPlaceId` integer — The description of the universe.

## Other responses

- `400` — 26: The pagination cursor is invalid or incompatible with the current request.
- `404` — 3: The game 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/e15802062270/schema)