Skip to main content

relationships.list

Overview

  • Returns all relationships a character has, with each partner's name and relationship stats. Use min_value to filter out weak (e.g. crowd) relationships.

Metadata

FieldValue
DisplayList Relationships
Categoryrelationships
AccessPublic
ScopeB2Authority
Tags
Aliases

Parameters

NameTypeRequiredDefaultDescription
owner_identityIdyesOwner character entity ID
min_valuefloatnoOnly include relationships whose max stat value is >= this (default: 0)

Returns

  • Freeform result (shape is not fixed).

{ owner_id: int, count: int, relationships: [ { target_id: int, first_name: string, last_name: string, is_family: bool, stats: { <relationship_id>: { value: float, level: int } } } ] } — each relationship element has a stats object keyed dynamically by relationship stat id.

Usage

await inzoi.cli.execute('relationships.list', {
owner_id: 0,
min_value: 0.0, // optional
});