Read one problem

GET
/v1/problems/{id}

One problem and a page of what is behind it: each miss as a link to its call, conversation or journey, with when and on which channel. Never the words said.

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

Query Parameters

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

The problem and a page of the conversations, calls and journeys behind it, as links

application/json
  1. response
problem*
members*array<>
nextCursor*string|null
Example Request
curl "https://api.vlayers.ai/v1/problems/$PROBLEM_ID" \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "problem": {    "id": "0192f5fd-1625-7073-9c23-456789abcdef",    "agentId": "0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78",    "miss": "missing_information",    "missStep": "check_availability",    "name": "Did not have the answer at 'Check availability'",    "status": "active",    "firstSeenAt": "2026-10-20T15:04:05.000Z",    "lastSeenAt": "2026-10-20T15:04:05.000Z",    "members": 14,    "distinctContacts": 9,    "trend": {      "recent": 8,      "previous": 6    },    "byChannelClass": {      "immediate": 9,      "asynchronous": 5    },    "openProposalId": "0192f5fe-2736-7184-8d34-56789abcdef0"  },  "members": [    {      "subject": {        "kind": "conversation",        "conversationId": "0192f5b0-7c3e-7a51-9b2d-4e8f1a6c3d21"      },      "channel": "sms",      "at": "2026-10-20T15:04:05.000Z"    }  ],  "nextCursor": null}