---
title: "Get all icons for a badge"
method: GET
path: "/legacy-game-internationalization/v1/badges/{badgeId}/icons"
tags: ["Badges", "Localization"]
---

# Get all icons for a badge

`GET /legacy-game-internationalization/v1/badges/{badgeId}/icons`

## Request

- Base URL: `https://apis.roblox.com`
- URL: `https://apis.roblox.com/legacy-game-internationalization/v1/badges/{badgeId}/icons`
- Auth: one of:
  - API key in header `x-api-key`
  - OAuth 2
    - Authorization code: `https://apis.roblox.com/oauth/v1/authorize`
    - Token URL: `https://apis.roblox.com/oauth/v1/token` scopes: `legacy-badge:manage`

## Path parameters

- `badgeId` integer, required

## Query parameters

- `width` integer
- `height` integer

## Response `200`

OK

- RobloxWebWebAPIModelsApiArrayResponseRobloxGameInternationalizationApiGetBadgeIconResponse
  - `data` RobloxGameInternationalizationApiGetBadgeIconResponse[]
    - `imageId` string
    - `imageUrl` string
    - `state` 'Approved' | 'PendingReview' | 'UnAvailable' | 'Rejected' | 'Error': Enum for image status.
    - `languageCode` string

## Other responses

- `400`: 52: Image dimensions are invalid 62: Invalid game badge id
- `401`: 0: Authorization has been denied for this request.
- `500`: 0: An unknown error occurred.
- `503`: 17: Feature is disabled

## Changes

- **2026-10-14** `5dcfa33df56a`: 1 info
  - the security scope `legacy-badge:manage` was added to the endpoint's security scheme `roblox-oauth2`

[Operation history](https://skmtc.dev/roblox/apis/roblox-api/changes/legacy-game-internationalization/v1/badges/:badgeId/icons/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)