---
title: "List this agent's simulation suites with their latest health"
method: GET
path: "/v1/agents/{agent_id}/simulation-suites"
---

# List this agent's simulation suites with their latest health

`GET /v1/agents/{agent_id}/simulation-suites`

## Request

- Base URL: `https://api.skysay.ai`
- URL: `https://api.skysay.ai/v1/agents/{agent_id}/simulation-suites`
- Auth: none declared

Bounded and stably ordered newest-first, with an opaque cursor and an explicit has_more. A suite that has never run reports state=never_run rather than a zero pass rate. Returns 404 while Simulations Lab is not enabled for the deployment.

## Path parameters

- `agent_id` string, required

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

Bounded suite page with latest-run health

## Other responses

- `404`: Agent not found, or Simulations Lab is not enabled

---

[API](https://skmtc.dev/skysay/apis/skysay-api.md) · [All operations](https://skmtc.dev/skysay/apis/skysay-api/llms.txt) · [OpenAPI document](https://skmtc.dev/skysay/apis/skysay-api/revisions/95b8c66f99aa?raw)