---
title: "Fetches game icon URLs for a list of universes' root places. Ids that do not correspond to a valid universe will be filtered out.
The ordering of the results is not guaranteed to be the same as the inputs. In order to correlated inputs with outputs please
use the 'targetId' of the objects in the result array."
method: GET
path: "/v1/games/icons"
tags: ["Thumbnails", "Universes"]
---

# Fetches game icon URLs for a list of universes' root places. Ids that do not correspond to a valid universe will be filtered out.
The ordering of the results is not guaranteed to be the same as the inputs. In order to correlated inputs with outputs please
use the 'targetId' of the objects in the result array.

`GET /v1/games/icons`

## Query parameters

- `universeIds` integer[], required
- `returnPolicy` 'PlaceHolder' | 'ForcePlaceHolder' | 'AutoGenerated' | 'ForceAutoGenerated'
- `size` '50x50' | '128x128' | '150x150' | '256x256' | '420x420' | '512x512'
- `format` 'Png' | 'Jpeg' | 'Webp'
- `isCircular` boolean

## Response `200`

OK

## Other responses

- `400` — 1: There are too many requested Ids. 2: The requested image format is invalid. Please see documentation for valid thumbnail format parameter name and values. 3: The requested size is invalid. Please see documentation for valid thumbnail size parameter name and format. 4: The requested Ids are invalid, of an invalid type or missing. 8: The requested return policy is invalid (must be PlaceHolder, AutoGenerated or ForceAutoGenerated). 10: Circular thumbnail requests are not allowed
- `403` — 9: User not authorized to use AutoGenerated or ForceAutoGenerated return policies.

---

[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/revisions/958b2b40425d/schema)