GET /v1/staff/characters/pending — List Pending Characters

Use this endpoint to retrieve a paginated list of all characters that have been submitted for staff review and are currently in the pending_approval state. This is the primary queue staff members work through when processing character applications. Results are paginated — use the page and limit query parameters to navigate through the list.

This endpoint is restricted to users who hold at least one of the following permissions: MODERATOR_CHIEF, ADMINISTRATOR, or DEVELOPER. Requests from accounts without these roles are rejected with 403.

Endpoint

GET https://api.cacolombia.com/v1/staff/characters/pending

Query Parameters

number

The page number to retrieve. Must be a positive integer. Defaults to 1.

number

The number of characters to return per page. Must be between 1 and 50. Defaults to 20.

Response

A successful 200 response returns the characters on the requested page along with pagination metadata:

array

An array of character objects currently awaiting review. Each object contains the full character data as returned by getApiCharacterData(). Returns an empty array if there are no pending characters on the requested page.

object

Pagination information for the result set.

Show meta fields

number

The total number of pending characters across all pages.

number

The current page number returned in this response.

number

The number of results per page used for this response.

number

The total number of pages available given the current limit.

Example Request

curl -X GET "https://api.cacolombia.com/v1/staff/characters/pending?page=1&limit=20" \
  -H "Authorization: Bearer <your_token>"

Example Response

{
  "characters": [
    {
      "characterId": "998877665544332211",
      "userId": "112233445566778899",
      "firstNames": "Carlos",
      "lastNames": "Rodríguez",
      "age": 30,
      "height": 178,
      "gender": "Masculino",
      "bloodType": "O+",
      "nationality": {
        "nombre": "Colombiano",
        "abrev": "COL",
        "lugar": "Colombia"
      },
      "dob": "01/03/1994",
      "avatarHash": "abc123def456",
      "idCardHash": null,
      "fullBodyHash": "def456ghi789",
      "avatar3dHash": null,
      "avatar3dCamera": null,
      "avatar3dAABB": null,
      "idStatus": "pending_approval",
      "wallet": null,
      "createdAt": "2024-06-07T14:00:00.000Z",
      "updatedAt": "2024-06-07T14:05:00.000Z"
    }
  ],
  "meta": {
    "total": 47,
    "page": 1,
    "limit": 20,
    "totalPages": 3
  }
}

Error Responses

Status	Description
`401`	You are not authenticated. Provide a valid authorization token with your request.
`403`	Your account does not hold any of the required staff permissions.

Rate limiting applies to this endpoint. You can call it at most 10 times per minute. Use the meta.totalPages value to determine whether you need to fetch additional pages rather than polling repeatedly.

Overview

Auth & OAuth

Users

Characters

Economy

Banking

Staff

Utilities

GET /v1/staff/characters/pending — List Pending Characters

Endpoint

Query Parameters

Response

Example Request

Example Response

Error Responses

​Endpoint

​Query Parameters

​Response

​Example Request

​Example Response

​Error Responses

Endpoint

Query Parameters

Response

Example Request

Example Response

Error Responses