# List an agent's journeys

Source: https://docs.vlayers.ai/reference/agents/list-agent-journeys

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

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.

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string | yes | The agent id. Example: `"0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78"` |
| `since` | query | string | no | Only journeys opened after this ISO timestamp. Example: `"2026-10-20T15:04:05.000Z"` |
| `status` | query | "open" \| "closed" | no | Only `open` or `closed` journeys. Example: `"closed"` |
| `met` | query | "true" \| "false" | no | Only journeys that met (`true`) or missed (`false`) the goal. Example: `"false"` |
| `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/agents/$AGENT_ID/journeys?status=closed&limit=20" \
  -H "Authorization: Bearer $VOICELAYER_API_KEY"
```

TypeScript:

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

const voicelayer = new VoiceLayer();

const { journeys } = await voicelayer.agents.listJourneys('<agent-id>', {
  status: 'closed',
  limit: 20
});
console.log(journeys);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.agents.list_journeys("<agent-id>", status="closed", limit=20)
print(result.journeys)
```

## Response `200`

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