Get Full-Body Roblox Avatar — GET /roblox/avatar

Use this endpoint to retrieve a user’s full-body Roblox avatar image. The image is sourced from the Roblox thumbnails API at 720×720 PNG resolution. By default the endpoint returns a JSON object containing the image URL. Pass download=true to instead receive the raw PNG binary directly in the response body, which is useful for displaying the avatar without an extra round trip to the Roblox 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

Path Parameters

string

required

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

Query Parameters

string

Pass true to receive the avatar 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 full-body Roblox avatar image hosted on the Roblox CDN, at 720×720 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" \
  --cookie "access_token=<your_access_token>"

Example Response (JSON URL)

{
  "imageUrl": "https://tr.rbxcdn.com/abc123def456/720/720/Avatar/Png/noFilter"
}

Example Request (Binary Download)

curl -X GET "https://api.cacolombia.com/v1/users/112233445566778899/roblox/avatar?download=true" \
  --cookie "access_token=<your_access_token>" \
  --output avatar.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 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 Full-Body Roblox Avatar — GET /roblox/avatar

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