---
title: cascades_list_test_cases
description: List the pre-registered sandbox test-case subjects for a cascade — the synthetic applicants the CRS Testcase Service has authored for that cascade's…
canonical_url: "https://cascades.crscreditapi.com/docs/mcp/tools/cascades_list_test_cases"
doc_version: "1.0.0"
last_updated: "2026-10-09T14:37:54Z"
source: docs/mcp/tools.json
---

# `cascades_list_test_cases`

List the pre-registered sandbox test-case subjects for a cascade — the synthetic applicants the CRS Testcase Service has authored for that cascade's products (e.g. specific credit-score bands). Use this when asked to "run the test cases", "try a sample applicant", or to sanity-check a cascade without hand-writing applicant data. Each result carries a ready-to-run `payload` (applicant + property) you pass straight to cascades_trigger_workflow with execution_mode "test". Returns an empty list when the cascade's products have no registered subjects.

- **Access:** read
- **Scopes:** `workflows:read`
- **REST operation:** `GET /api/v1/workflows/{id}/test_cases` — [listWorkflowTestCases](https://cascades.crscreditapi.com/docs/api/workflows/list-workflow-test-cases.md)

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `workflow_id` | `integer` | yes | Workflow id. Only workflows owned by the token's account resolve; a foreign or deleted id returns `404`. |
| `environment` | `string` | no | Target environment: "prod" (default) or "dev". One of: `dev`, `prod`. |

## Example call

```json
{
  "name": "cascades_list_test_cases",
  "arguments": {
    "workflow_id": 157
  }
}
```

## Example result

```json
{
  "object": "test_case_list",
  "workflow_id": 157,
  "test_cases": [
    {
      "id": 54,
      "case_name": "Cascades_Credit_720",
      "product_code": "TUC1001",
      "payload": {
        "applicant": {
          "first_name": "Sandrx",
          "last_name": "Bowkey"
        },
        "property": {
          "state": "MD"
        }
      }
    }
  ]
}
```

## Sitemap

See the full [sitemap](https://cascades.crscreditapi.com/sitemap.md) for all pages.