Thrive AI Health
Api reference

Retrieve metadata for a completed voice call

Returns call-level metadata (start/end timestamps, duration, status). Transcripts are stored on the associated thread — fetch them via `GET /threads/{thread_id}/messages`.

GET
/v1/users/{user_id}/voice/calls/{call_id}

Authorization

MemberBearer
AuthorizationBearer <token>

Member-scoped JWT minted by POST /v1/auth/token. Required on every /v1/users/{user_id}/... route; the token's sub claim must match the path user_id.

In: header

Path Parameters

user_id*User Id
Formatuuid
call_id*Call Id
Formatuuid

Header Parameters

org-id?string|null
x-user-id?string|null
x-request-id?string|null
traceparent?string|null
Idempotency-Key?|null

Response Body

application/json

application/json

curl -X GET "https://loading/v1/users/497f6eca-6276-4993-bfeb-53cbbbba6f08/voice/calls/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "data": {
    "call_id": "0d0a16ab-a508-4d58-bf24-5dc3cb248f3e",
    "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",
    "thread_id": "1de43264-67cb-48af-89f9-e865c375bb84",
    "started_at": "2019-08-24T14:15:22Z",
    "ended_at": "2019-08-24T14:15:22Z",
    "duration_seconds": 0,
    "status": "completed"
  }
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Create a voice session and return LiveKit credentials

Returns a short-lived LiveKit token (~1 minute TTL) and connection URL. The client must connect immediately after receiving. Pass `thread_id` to resume an existing thread; omit to start a new one. `coach_mode` selects conversational (`COACH`) vs interviewer (`INTAKE`) posture; `additional_instructions` injects runtime context.

Paginated voice call history

Sort order is `started_at` descending. Partners use this to render a call-history surface in the member's conversation UI. Service caps `limit` at 50 internally — requests above 50 are silently capped rather than rejected.