Get relationship scores

GET

/v1/sessions/:session_id/relationship-scores

GET

/v1/sessions/:session_id/relationship-scores

curl https://api.loreos.app/v1/sessions/00000000-0000-0000-0000-000000000000/relationship-scores \
     -H "Authorization: Bearer <token>"

{
  "schema_version": "v0",
  "data": {
    "session_id": "00000000-0000-0000-0000-000000000000",
    "redacted": true,
    "opt_in_required": true,
    "relationship_scores": [],
    "score_contract": {
      "score_version": "relationship_scores.v1",
      "updated_at": null,
      "dimension_count": 0,
      "scope": "session",
      "aggregation": "latest_final_relational_state",
      "scale": {
        "min": 0,
        "max": 1
      },
      "semantics": {
        "monotonic": false,
        "may_move_down": true,
        "may_decay": true,
        "cross_user_comparable": "directionally comparable within the same app/schema, but not a universal leaderboard-normalized score"
      }
    },
    "omitted_fields": [
      "raw_signal_events",
      "raw_extractor_deltas",
      "prompt_text"
    ]
  },
  "next_actions": [
    {
      "command": "GET /v1/me",
      "description": "Get the app_id for this API key before patching app settings."
    },
    {
      "command": "PATCH /v1/apps/<app_id> {\"expose_relational_numerics\": true}",
      "description": "Opt this app into final relationship-score numerics"
    }
  ]
}

Read the live relationship score meter for one app-owned session.

This is an explicit alias for the opt-in relational_meter on GET /v1/sessions/{id}/state. By default it returns a redacted empty meter. Use GET /v1/me to discover the app_id for your key, then PATCH /v1/apps/{app_id} {"expose_relational_numerics": true}. After opt-in, this endpoint returns final per-dimension 0..1 values such as affection_toward_user and romantic_interest for dating schemas. Raw extractor deltas, patch history, signal events, critic reasoning, and prompt text are never exposed.

Typical opt-in response:

{
  "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"
    },
    {
      "key": "romantic_interest",
      "label": "romantic interest",
      "value": 0.41,
      "lower_is_open": false,
      "updated_at": "2026-06-22T05:10:00+00:00",
      "version": "2026-06-22T05:10:00+00:00"
    }
  ],
  "score_contract": {
    "score_version": "relationship_scores.v1",
    "scale": {"min": 0.0, "max": 1.0},
    "semantics": {"monotonic": false, "may_move_down": true}
  }
}

Authentication

AuthorizationBearer

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

Path parameters

session_idstringRequired

Response

Successful Response

Errors

422

Unprocessable Entity Error