List an agent's journeys

GET
/v1/agents/{id}/journeys

A journey is one contact's run of conversations with one agent, calls and texts together, from the first until the contact goes quiet, scored against the agent's goal as one. Only a goal that lists journey among the things it judges produces them. Each row says whether the goal was met, how it was decided (rule: a conversation in it already met the goal, so nothing was charged) and, on a miss, why as a closed value. Ids, times and counts only: no words.

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 agent id.

Query Parameters

since?string

Only journeys opened after this ISO timestamp.

Formatdate-time
status?string

Only open or closed journeys.

Value in"open""closed"
met?string

Only journeys that met (true) or missed (false) the goal.

Value in"true""false"
cursor?string

The nextCursor of the previous page.

Lengthlength <= 512
limit?integer

How many items to return, 1–100. Default 25.

Range1 <= value <= 100

Response Body

A page of the agent's journeys, newest first

application/json
  1. response
journeys*array<>
nextCursor*string|null
Example Request
curl "https://api.vlayers.ai/v1/agents/$AGENT_ID/journeys?status=closed&limit=20" \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "journeys": [    {      "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"    }  ],  "nextCursor": null}