---
title: "Fetches thumbnail URLs for a list of groups. Ids that do not correspond to groups will be filtered out."
method: GET
path: "/v1/groups/icons"
tags: ["Groups", "Thumbnails"]
---

# Fetches thumbnail URLs for a list of groups. Ids that do not correspond to groups will be filtered out.

`GET /v1/groups/icons`

## Query parameters

- `groupIds` integer[], required
- `size` '150x150' | '420x420'
- `format` 'Png' | '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. 10: Circular thumbnail requests are not allowed

---

[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/e15802062270/schema)