Export character relationship scores

GET

/v1/characters/:slug/relationship-scores

GET

/v1/characters/:slug/relationship-scores

curl -G https://api.loreos.app/v1/characters/mira-demo/relationship-scores \
     -H "Authorization: Bearer <token>" \
     -d limit=50

{
  "schema_version": "v0",
  "data": {
    "character": "mira-demo",
    "redacted": false,
    "opt_in_required": false,
    "relationship_score_exports": [
      {
        "session_id": "00000000-0000-0000-0000-000000000000",
        "character": "mira-demo",
        "external_user_ref": "user_123",
        "updated_at": "2026-06-22T05:10:00+00:00",
        "version": "2026-06-22T05:10:00+00:00",
        "relationship_scores": [
          {
            "key": "affection_toward_user",
            "label": "affection",
            "value": 0.62,
            "lower_is_open": false,
            "updated_at": "2026-06-22T05:10:00+00:00",
            "version": "2026-06-22T05:10:00+00:00"
          }
        ]
      }
    ],
    "next_cursor": null,
    "has_more": false,
    "score_contract": {
      "score_version": "relationship_scores.v1",
      "scope": "character_export",
      "aggregation": "latest_final_relational_states_by_session",
      "scale": {
        "min": 0,
        "max": 1
      }
    }
  }
}

Export final relationship score meters for one app-owned character.

This is the app-dashboard companion to GET /v1/sessions/{id}/relationship-scores. It returns one row per app-owned session for the character, keyed by session_id and external_user_ref. It uses the same app opt-in as the session endpoint: until expose_relational_numerics is true, the response is redacted and empty. Raw extractor deltas, patch history, signal events, critic reasoning, and prompt text are never exposed.

Authentication

AuthorizationBearer

LoreOS runtime API key (ck_...), sent as Authorization: Bearer <key>.

Path parameters

slugstringRequired

Query parameters

limitintegerOptional1-200Defaults to 50

cursorstring or nullOptional

Opaque pagination cursor returned as next_cursor.

Response

Successful Response

Errors

422

Unprocessable Entity Error