---
title: "Get Avatar Headshots for the given CSV of userIds"
method: GET
path: "/v1/users/avatar-headshot"
tags: ["Avatars", "Thumbnails"]
---

# Get Avatar Headshots for the given CSV of userIds

`GET /v1/users/avatar-headshot`

## Query parameters

- `userIds` integer[], required
- `includeBackground` boolean
- `size` '48x48' | '50x50' | '60x60' | '75x75' | '100x100' | '110x110' | '150x150' | '180x180' | '352x352' | '420x420' | '720x720'
- `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. 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/versions/e15802062270/schema)