Export external-user relationship scores

GET

/v1/external-users/:external_user_ref/relationship-scores

GET

/v1/external-users/:external_user_ref/relationship-scores

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

1 {
2   "schema_version": "v1",
3   "data": {
4     "external_user_ref": "user_123",
5     "character": "mira-demo",
6     "redacted": false,
7     "opt_in_required": false,
8     "relationship_score_exports": [
9       {
10         "session_id": "00000000-0000-0000-0000-000000000000",
11         "character": "mira-demo",
12         "external_user_ref": "user_123",
13         "updated_at": "2026-06-22T05:10:00+00:00",
14         "version": "2026-06-22T05:10:00+00:00",
15         "relationship_scores": [
16           {
17             "key": "romantic_interest",
18             "label": "romantic interest",
19             "value": 0.41,
20             "lower_is_open": false,
21             "updated_at": "2026-06-22T05:10:00+00:00",
22             "version": "2026-06-22T05:10:00+00:00"
23           }
24         ]
25       }
26     ],
27     "next_cursor": null,
28     "has_more": false
29   }
30 }

Export final relationship score meters for one app-owned end-user.

Returns one row per session for this external_user_ref. Use character=slug to narrow the export to a single character. The same expose_relational_numerics opt-in and redaction boundary as the session score endpoint applies.

Authentication

AuthorizationBearer

LoreOS API key, sent as Authorization: Bearer <key>.

Path parameters

external_user_refstringRequired

Query parameters

characterstring or nullOptional

Optional character slug filter for this user's score export.

limitintegerOptional1-200Defaults to 50

cursorstring or nullOptional

Opaque pagination cursor returned as next_cursor.

Response

Successful Response

Errors

422

Unprocessable Entity Error