# List a suite's cases

Source: https://docs.vlayers.ai/reference/test/list-test-cases

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

The cases of a test suite: each is the contact's lines (a conversation that went wrong, replayed, or a script you wrote) and what its run must reach.

Requires an API key with the `workspace:read` scope.

| Name | In | Type | Required | Description |
|---|---|---|---|---|
| `id` | path | string | yes | The suite id. Example: `"0192f5f8-c1d0-7b2e-8d7e-8f9012345678"` |

## Request

cURL:

```bash
curl "https://api.vlayers.ai/v1/tests/$SUITE_ID/cases" \
  -H "Authorization: Bearer $VOICELAYER_API_KEY"
```

TypeScript:

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

const voicelayer = new VoiceLayer();

const { cases } = await voicelayer.test.listCases('<suite-id>');
console.log(cases);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.test.list_cases("<suite-id>")
print(result.cases)
```

## Response `200`

```json
{
  "cases": [
    {
      "id": "0192f5f9-d2e1-7c3f-9e8f-90123456789a",
      "suiteId": "0192f5f8-c1d0-7b2e-8d7e-8f9012345678",
      "agentId": "0192f5c2-6f7a-7b9c-8d1e-2f3a4b5c6d78",
      "name": "Refund went wrong",
      "inputKind": "replay",
      "turns": [
        "I was charged twice",
        "Yes, the card ending 4242"
      ],
      "sourceCallId": null,
      "sourceConversationId": "0192f5b0-7c3e-7a51-9b2d-4e8f1a6c3d21",
      "expectations": [
        {
          "evaluationId": "0192f5f7-b0cf-7a1d-9c6d-7e8f90123456",
          "expect": {
            "bool": true
          }
        }
      ],
      "createdBy": "user_2abc",
      "createdAt": "2026-10-20T15:04:05.000Z",
      "expiresAt": null
    }
  ]
}
```
