Read one journey

GET
/v1/journeys/{id}

One journey: the conversations and calls in it as links, never their words, and how the goal judged it as a few blocks a person reads. Reading what was said stays with a signed-in session.

Requires an API key with the workspace:read scope.

Authorization

apiKey
headerAuthorizationBearer <token>

A secret API key from the dashboard (Developers → API keys): vl_live_…, or vl_test_… for test mode. Each operation says which scope the key needs.

Path Parameters

id*string

The journey id.

Response Body

The journey: its members as links, never their words, and how the goal judged it

application/json
  1. response
journey*
members*array<>
analyses*array<>
Example Request
curl "https://api.vlayers.ai/v1/journeys/$JOURNEY_ID" \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "journey": {    "id": "0192f5fc-0514-7f62-8b12-3456789abcde",    "agentId": "0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78",    "status": "closed",    "closedReason": "quiet",    "openedAt": "2026-10-20T15:04:05.000Z",    "lastMemberAt": "2026-10-20T15:04:05.000Z",    "closesAt": "2026-10-20T15:04:05.000Z",    "memberCount": 2,    "met": false,    "method": "judge",    "refusalCode": null,    "scoringCostUsd": 0.004,    "miss": "missing_information",    "missStep": "check_availability"  },  "members": [    {      "kind": "conversation",      "id": "0192f5b0-7c3e-7a51-9b2d-4e8f1a6c3d21",      "channel": "sms",      "joinedAt": "2026-10-20T15:04:05.000Z"    }  ],  "analyses": [    {      "analyzerId": "vl/qa",      "instanceId": "0192f5fb-f403-7e51-9a01-23456789abcd",      "label": "Quality review",      "at": "2026-10-20T15:04:05.000Z",      "blocks": [        {          "type": "status",          "label": "Quality 82 of 100",          "tone": "ok"        },        {          "type": "facts",          "items": [            {              "label": "Sentiment",              "value": "positive"            }          ]        }      ]    }  ]}