Skip to main content
GET
/
context
/
characters
/
{game_id}
/
{world_id}
/
{character_id}
Get character details
curl --request GET \
  --url https://app.npcbuilder.com/api/context/characters/{game_id}/{world_id}/{character_id} \
  --header 'Authorization: Bearer <token>'
{
  "character_id": "character789",
  "character": {
    "id": "character789",
    "name": "Aragorn",
    "description": "A brave warrior with a mysterious past.",
    "age": "adult",
    "gender": "Male",
    "role": "protagonist",
    "tone": "mysterious",
    "traits": [
      "brave"
    ],
    "items": [
      {
        "itemName": "Sword",
        "unit": "Piece",
        "value": 100,
        "type": "trade",
        "description": "A sharp sword."
      }
    ],
    "events": [
      {
        "eventName": "Attack",
        "type": "action",
        "description": "Act of violence against another person."
      }
    ],
    "quests": [
      {
        "description": "Retrieve the lost artifact.",
        "objective": "Find and return the artifact.",
        "reward": "500 gold coins"
      }
    ]
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.npcbuilder.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

game_id
string
required

The unique identifier for the game.

Example:

"game123"

world_id
string
required

The unique identifier for the world.

Example:

"world456"

character_id
string
required

The unique identifier for the character.

Example:

"character789"

Query Parameters

session_id
string

(Optional) The player's session ID.

Example:

"60Z5aZjIuFlyYbjbZZKe"

Response

Character retrieved successfully.

character_id
string

UID of the character.

Example:

"character789"

character
object

Public character DTO. Internal fields such as knowledge, relationships, filters, memory, and model are omitted.