Get relationship scores
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:
```json
{
"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_id
Response
Successful Response
Errors
422
Unprocessable Entity Error