> ## Documentation Index
> Fetch the complete documentation index at: https://apidocs.cacolombia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Roblox Avatar Bust — GET /roblox/avatar-bust

> Retrieve a user's Roblox avatar bust (upper body) image at 420×420 PNG resolution. Returns a JSON image URL or raw PNG binary when download=true.

Use this endpoint to retrieve a user's Roblox avatar bust image — a cropped, upper-body portrait — through the CA Colombia API. The image is sourced from the Roblox thumbnails API at 420×420 PNG resolution. This format is well-suited for profile cards, sidebars, and other compact UI contexts where a full-body avatar would be too large.

By default, the endpoint returns a JSON object with an image URL. Pass `download=true` to receive the raw PNG binary directly, which is useful if you want to serve or cache the image yourself without an additional request to the CDN.

<Note>
  This endpoint only works for your own account. The authenticated session must belong to the same `userId` in the path. Requests are rate-limited to **5 per minute**.
</Note>

<Warning>
  The user must have a Roblox account linked to their CA Colombia profile. If no Roblox provider is connected, the request will return a `403 Forbidden` error.
</Warning>

## Endpoint

```text theme={null}
GET https://api.cacolombia.com/v1/users/:userId/roblox/avatar-bust
```

## Path Parameters

<ParamField path="userId" type="string" required>
  The Snowflake ID of the user whose avatar bust you want to retrieve. Must match the authenticated user's ID.
</ParamField>

## Query Parameters

<ParamField query="download" type="string">
  Pass `true` to receive the avatar bust image as raw PNG binary (`Content-Type: image/png`) instead of a JSON response with an image URL.
</ParamField>

## Response

When `download` is omitted or not `true`, the response is a JSON object:

<ResponseField name="imageUrl" type="string">
  A URL pointing to the user's Roblox avatar bust image hosted on the Roblox CDN, at 420×420 resolution in PNG format.
</ResponseField>

When `download=true`, the response body is raw PNG binary with `Content-Type: image/png`.

## Example Request (JSON URL)

```bash theme={null}
curl -X GET "https://api.cacolombia.com/v1/users/112233445566778899/roblox/avatar-bust" \
  --cookie "access_token=<your_access_token>"
```

## Example Response (JSON URL)

```json theme={null}
{
  "imageUrl": "https://tr.rbxcdn.com/def456ghi789/420/420/AvatarBust/Png/noFilter"
}
```

## Example Request (Binary Download)

```bash theme={null}
curl -X GET "https://api.cacolombia.com/v1/users/112233445566778899/roblox/avatar-bust?download=true" \
  --cookie "access_token=<your_access_token>" \
  --output avatar-bust.png
```

When `download=true`, the response body is the raw PNG file with no JSON envelope.

## Error Responses

| Status | Error                                       | Description                                                                            |
| ------ | ------------------------------------------- | -------------------------------------------------------------------------------------- |
| `401`  | `Unauthorized`                              | No valid authentication token was provided.                                            |
| `403`  | `Unauthorized`                              | The authenticated user does not match the `userId` in the path.                        |
| `403`  | `Forbidden`                                 | The user does not have a Roblox account linked to their profile.                       |
| `404`  | `Unknown User`                              | No user was found with the given `userId`.                                             |
| `500`  | `Could not retrieve the user's avatar-bust` | The Roblox thumbnails API returned an error or the avatar bust could not be processed. |
| `500`  | `Internal Server Error`                     | The image binary could not be streamed when using `download=true`.                     |