---
title: "Returns a list of thumbnails with varying types and sizes"
method: POST
path: "/v1/batch"
tags: ["Thumbnails"]
---

# Returns a list of thumbnails with varying types and sizes

`POST /v1/batch`

## Headers

- `Roblox-Place-Id` integer

## Request body

- RobloxThumbnailsApisModelsThumbnailBatchRequest[]
  - `requestId` string — The request id. (Generated client side, used to represent the items in the request)
  - `targetId` integer — The thumbnail target id
  - `token` string — Alternative ase token used to identify a thumbnail
  - `alias` string — Alternative string used to identify a thumbnail instead of targetId
  - `type` 'Avatar' | 'AvatarHeadShot' | 'GameIcon' | 'BadgeIcon' | 'GameThumbnail' | 'GamePass' | 'Asset' | 'BundleThumbnail' | 'Outfit' | 'GroupIcon' | 'DeveloperProduct' | 'AvatarBust' | 'AutoGeneratedAsset' | 'PlaceIcon' | 'AutoGeneratedGameIcon' | 'ForceAutoGeneratedGameIcon' | 'Look' | 'CreatorContextAsset' | 'Screenshot' — The type of the thumbnails ['Avatar' = 1, 'AvatarHeadShot' = 2, 'GameIcon' = 3, 'BadgeIcon' = 4, 'GameThumbnail' = 5, 'GamePass' = 6, 'Asset' = 7, 'BundleThumbnail' = 8, 'Outfit' = 9, 'GroupIcon' = 10, 'DeveloperProduct' = 11, 'AvatarBust' = 12, 'AutoGeneratedAsset' = 13, 'PlaceIcon' = 14, 'AutoGeneratedGameIcon' = 15, 'ForceAutoGeneratedGameIcon' = 16, 'Look' = 17, 'CreatorContextAsset' = 18, 'Screenshot' = 19]
  - `size` string — The thumbnail size
  - `format` string — The thumbnail format
  - `isCircular` boolean — Is the thumbnail circular shape
  - `accessContext` string — Access context for asset permission checks (only relevant for Asset thumbnail types)
  - `headShape` string — Head shape for dynamic head thumbnails (only relevant for Asset thumbnail types with dynamic head)
  - `includeBackground` boolean — Whether to include a background in avatar thumbnails (defaults to false)

## 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. 7: The specified type is not supported by the batch endpoint
- `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/versions/e15802062270/schema)