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

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.

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.

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.

Endpoint

GET https://api.cacolombia.com/v1/users/:userId/roblox/avatar-bust

Path Parameters

string

required

The Snowflake ID of the user whose avatar bust you want to retrieve. Must match the authenticated user’s ID.

Query Parameters

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.

Response

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

string

A URL pointing to the user’s Roblox avatar bust image hosted on the Roblox CDN, at 420×420 resolution in PNG format.

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

Example Request (JSON URL)

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

Example Response (JSON URL)

{
  "imageUrl": "https://tr.rbxcdn.com/def456ghi789/420/420/AvatarBust/Png/noFilter"
}

Example Request (Binary Download)

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`.

Overview

Auth & OAuth

Users

Characters

Economy

Banking

Staff

Utilities

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

Endpoint

Path Parameters

Query Parameters

Response

Example Request (JSON URL)

Example Response (JSON URL)

Example Request (Binary Download)

Error Responses

​Endpoint

​Path Parameters

​Query Parameters

​Response

​Example Request (JSON URL)

​Example Response (JSON URL)

​Example Request (Binary Download)

​Error Responses

Endpoint

Path Parameters

Query Parameters

Response

Example Request (JSON URL)

Example Response (JSON URL)

Example Request (Binary Download)

Error Responses