Get User Profile — GET /v1/users/:userId — CA Colombia

Use this endpoint to retrieve a CA Colombia user’s profile by their unique Snowflake ID. The response includes account metadata, character limits, and the user’s full character list. You can optionally request linked provider data (Discord and Roblox) and character signature data by passing query parameters.

You can only retrieve your own user profile unless your token carries SERVICE_ADMINISTRATOR or DEVELOPER permissions. Attempting to fetch another user’s profile without those permissions will return a 403 Forbidden error.

Endpoint

GET https://api.cacolombia.com/v1/users/:userId

Path Parameters

string

required

The Snowflake ID of the user to retrieve.

Query Parameters

string

Pass true to include the user’s linked provider accounts (Discord and Roblox) in the response. Omit or pass any other value to exclude provider data.

string

Pass true to include the signatureData field on character objects (active character and the characters array). Omit or pass any other value to exclude it.

Response

string

The user’s unique Snowflake ID.

string

A numeric string representing the user’s permission bitfield.

number

The maximum number of characters this user is allowed to create.

object | null

The user’s currently active character, or null if none is set. See the character object shape below.

Show activeCharacter fields

string

Unique Snowflake ID of the character.

string

The Snowflake ID of the user who owns the character.

string

The character’s first name(s).

string

The character’s last name(s).

number

The character’s age in years.

number

The character’s height in centimetres.

string

The character’s gender. Either Masculino or Femenino.

string

The character’s blood type (e.g. O+, A-, AB+).

object

An object describing the character’s nationality with nombre, abrev, and lugar fields.

string

The character’s date of birth in DD/MM/YYYY format.

string | null

Hash of the character’s avatar image, or null if not set.

string | null

Hash of the character’s ID card image, or null if not set.

string | null

Hash of the character’s full-body image, or null if not set.

string | null

Hash of the character’s 3D avatar, or null if not set.

object | null

Saved camera configuration for the 3D avatar, or null if not set.

object | null

Saved axis-aligned bounding box for the 3D avatar, or null if not set.

string

The character’s ID card approval status. One of draft, pending_approval, or approved.

object | null

The character’s wallet, or null if no wallet exists.

string | null

Only present when signature=true is passed. The character’s signature data string, or null if not set.

string

ISO 8601 timestamp of when the character was created.

string

ISO 8601 timestamp of when the character was last updated.

array

An array of all character objects belonging to the user. Each item has the same shape as activeCharacter above.

string

ISO 8601 timestamp of when the user account was created.

string

ISO 8601 timestamp of when the user account was last updated.

array

Only present when providers=true is passed. An array of [providerName, providerObject] tuples for each linked account.

Show provider tuple fields

string

The provider name. Either "discord" or "roblox".

string

The CA Colombia Snowflake ID of the user who owns this provider link.

string

The Snowflake ID of this provider record.

string

The provider name. Either "discord" or "roblox".

string

The user’s ID on the external platform (e.g. Discord user ID or Roblox user ID).

object

Provider-specific metadata returned by the external platform at the time of linking.

Example Request

curl -X GET "https://api.cacolombia.com/v1/users/112233445566778899?providers=true" \
  --cookie "access_token=<your_access_token>"

Example Response

{
  "userId": "112233445566778899",
  "permissions": "1024",
  "maxCharacters": 2,
  "activeCharacter": {
    "characterId": "998877665544332211",
    "userId": "112233445566778899",
    "firstNames": "Carlos Alberto",
    "lastNames": "Reyes Gómez",
    "age": 28,
    "height": 175,
    "gender": "Masculino",
    "bloodType": "O+",
    "nationality": {
      "nombre": "Colombiano",
      "abrev": "COL",
      "lugar": "Colombia"
    },
    "dob": "15/04/1996",
    "avatarHash": "abc123def456",
    "idCardHash": "xyz789uvw012",
    "fullBodyHash": null,
    "avatar3dHash": null,
    "avatar3dCamera": null,
    "avatar3dAABB": null,
    "idStatus": "approved",
    "wallet": null,
    "createdAt": "2024-01-10T14:30:00.000Z",
    "updatedAt": "2024-06-01T09:15:00.000Z"
  },
  "characters": [
    {
      "characterId": "998877665544332211",
      "userId": "112233445566778899",
      "firstNames": "Carlos Alberto",
      "lastNames": "Reyes Gómez",
      "age": 28,
      "height": 175,
      "gender": "Masculino",
      "bloodType": "O+",
      "nationality": {
        "nombre": "Colombiano",
        "abrev": "COL",
        "lugar": "Colombia"
      },
      "dob": "15/04/1996",
      "avatarHash": "abc123def456",
      "idCardHash": "xyz789uvw012",
      "fullBodyHash": null,
      "avatar3dHash": null,
      "avatar3dCamera": null,
      "avatar3dAABB": null,
      "idStatus": "approved",
      "wallet": null,
      "createdAt": "2024-01-10T14:30:00.000Z",
      "updatedAt": "2024-06-01T09:15:00.000Z"
    }
  ],
  "createdAt": "2024-01-10T14:00:00.000Z",
  "updatedAt": "2024-06-01T09:15:00.000Z",
  "providers": [
    ["discord", { "userId": "112233445566778899", "providerId": "111122223333444455", "providerName": "discord", "externalId": "123456789012345678", "externalMetadata": {} }],
    ["roblox", { "userId": "112233445566778899", "providerId": "555566667777888899", "providerName": "roblox", "externalId": "987654321", "externalMetadata": {} }]
  ]
}

Error Responses

Status	Error	Description
`401`	`Unauthorized`	No valid authentication token was provided.
`403`	`Forbidden`	You attempted to fetch another user’s profile without sufficient permissions.
`404`	`Unknown User`	No user was found with the given `userId`.

Overview

Auth & OAuth

Users

Characters

Economy

Banking

Staff

Utilities

Get User Profile — GET /v1/users/:userId — CA Colombia

Endpoint

Path Parameters

Query Parameters

Response

Example Request

Example Response

Error Responses

​Endpoint

​Path Parameters

​Query Parameters

​Response

​Example Request

​Example Response

​Error Responses

Endpoint

Path Parameters

Query Parameters

Response

Example Request

Example Response

Error Responses