# Read one problem

Source: https://docs.vlayers.ai/reference/agents/get-problem

`GET /v1/problems/{id}` · scope `workspace:read`

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.

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string | yes | The problem id. Example: `"0192f5fd-1625-7073-9c23-456789abcdef"` |
| `cursor` | query | string | no | The `nextCursor` of the previous page. Example: `"MjAyNi0xMS0xMg"` |
| `limit` | query | integer | no | How many items to return, 1–100. Default 25. Example: `20` |

## Request

cURL:

```bash
curl "https://api.vlayers.ai/v1/problems/$PROBLEM_ID" \
  -H "Authorization: Bearer $VOICELAYER_API_KEY"
```

TypeScript:

```ts
import { VoiceLayer } from '@voicelayer/api';

const voicelayer = new VoiceLayer();

const { problem } = await voicelayer.agents.getProblem('<problem-id>');
console.log(problem.name);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.agents.get_problem("<problem-id>")
print(result.problem.name)
```

## Response `200`

```json
{
  "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
}
```
