GET /v1/users/:userId/characters — List Characters

Use this endpoint to retrieve all in-game characters that belong to a specific CA Colombia user. The response includes every character regardless of their current approval status, so you will see characters in draft, pending_approval, and approved states all in one call. You can optionally include avatar signature data for each character by passing the signature query parameter.

You can only list characters for your own account. The authenticated token must belong to the same userId in the path.

Endpoint

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

Path Parameters

string

required

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

Query Parameters

string

Pass true to include each character’s signatureData field in the response. Omit or pass any other value to exclude it.

Response

array

An array of character objects belonging to the user. The array will be empty if the user has no characters.

Show character fields

string

The character’s unique Snowflake ID.

string

The Snowflake ID of the user who owns this 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. One of O+, O-, A+, A-, B+, B-, AB+, AB-.

object

An object describing the character’s nationality with nombre (full name), abrev (abbreviation), and lugar (country/region) fields.

string

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

string | null

Hash identifier for the character’s avatar image, or null if not yet uploaded.

string | null

Hash identifier for the character’s generated ID card image, or null if not yet created.

string | null

Hash identifier for the character’s full-body reference image, or null if not yet uploaded.

string | null

Hash identifier for the character’s 3D GLB avatar model, or null if not yet uploaded.

object | null

Camera metadata for the 3D avatar, or null if not set.

object | null

Axis-aligned bounding box metadata 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 in-game wallet object, or null if no wallet exists yet.

string

The character’s avatar signature data. Only present when signature=true is passed.

string

ISO 8601 timestamp of when the character was created.

string

ISO 8601 timestamp of when the character was last updated.

Example Request

curl -X GET "https://api.cacolombia.com/v1/users/112233445566778899/characters" \
  -H "Authorization: Bearer <your_token>"

Example Response

{
  "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"
    },
    {
      "characterId": "111222333444555666",
      "userId": "112233445566778899",
      "firstNames": "Valentina",
      "lastNames": "Morales López",
      "age": 24,
      "height": 162,
      "gender": "Femenino",
      "bloodType": "A+",
      "nationality": {
        "nombre": "Colombiano",
        "abrev": "COL",
        "lugar": "Colombia"
      },
      "dob": "22/09/2000",
      "avatarHash": null,
      "idCardHash": null,
      "fullBodyHash": null,
      "avatar3dHash": null,
      "avatar3dCamera": null,
      "avatar3dAABB": null,
      "idStatus": "draft",
      "wallet": null,
      "createdAt": "2024-05-20T10:00:00.000Z",
      "updatedAt": "2024-05-20T10:00:00.000Z"
    }
  ]
}

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.
`404`	`Unknown User`	No user was found with the given `userId`.

Overview

Auth & OAuth

Users

Characters

Economy

Banking

Staff

Utilities

GET /v1/users/:userId/characters — List Characters

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