> ## Documentation Index > Fetch the complete documentation index at: https://doc.featherhq.com/llms.txt > Use this file to discover all available pages before exploring further. # List simulation suite runs across the org > Suite-run batches across the whole org, newest first — replaces fanning out one `GET /v1/sim-suites/{suite_id}/runs` call per suite. Each row inlines `suite_name` and swaps the per-suite endpoint's full child-run array for `counts`, so a page stays small. Live operational data: always revalidate. There is no `status` filter — the rollup is computed from child runs rather than stored, so filter on it client-side. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/sim-suites/runs openapi: 3.1.0 info: title: Feather API description: >- Unified customer experience platform API. Manages identity, conversations, memory, agents, procedures, policies, model routing, knowledge bases, integrations, and runtime execution. version: 1.87.0 servers: - url: https://api-sandbox.featherhq.com description: Sandbox - url: http://localhost:8000 description: Local dev security: [] paths: /v1/sim-suites/runs: get: tags: - sim_suites summary: List simulation suite runs across the org description: >- Suite-run batches across the whole org, newest first — replaces fanning out one `GET /v1/sim-suites/{suite_id}/runs` call per suite. Each row inlines `suite_name` and swaps the per-suite endpoint's full child-run array for `counts`, so a page stays small. Live operational data: always revalidate. There is no `status` filter — the rollup is computed from child runs rather than stored, so filter on it client-side. operationId: listAllSimulationSuiteRuns parameters: - name: suite_id in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' title: Suite Id - name: agent_id in: query required: false schema: anyOf: - type: string format: uuid - type: 'null' title: Agent Id - name: limit in: query required: false schema: type: integer maximum: 200 minimum: 1 default: 50 title: Limit - name: cursor in: query required: false schema: anyOf: - type: string - type: 'null' title: Cursor responses: '200': description: Successful Response content: application/json: schema: $ref: >- #/components/schemas/CursorPage_SimulationSuiteRunSummaryResponse_ '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Authentication required content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] components: schemas: CursorPage_SimulationSuiteRunSummaryResponse_: properties: items: items: $ref: '#/components/schemas/SimulationSuiteRunSummaryResponse' type: array title: Items next_cursor: anyOf: - type: string - type: 'null' title: Next Cursor has_more: type: boolean title: Has More type: object required: - items - has_more title: CursorPage[SimulationSuiteRunSummaryResponse] ErrorResponse: properties: error: type: string title: Error message: type: string title: Message retryable: anyOf: - type: boolean - type: 'null' title: Retryable retry_after: anyOf: - type: integer - type: 'null' title: Retry After type: object required: - error - message title: ErrorResponse description: Standard error response returned by all API error handlers. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError SimulationSuiteRunSummaryResponse: properties: id: type: string format: uuid title: Id organization_id: type: string format: uuid title: Organization Id suite_id: type: string format: uuid title: Suite Id suite_name: anyOf: - type: string - type: 'null' title: Suite Name agent_id: type: string format: uuid title: Agent Id agent_revision_id: anyOf: - type: string format: uuid - type: 'null' title: Agent Revision Id created_by: anyOf: - type: string - type: 'null' title: Created By created_at: type: string format: date-time title: Created At status: type: string title: Status counts: $ref: '#/components/schemas/SuiteRunStatusCounts' release_eval_status: anyOf: - type: string - type: 'null' title: Release Eval Status release_eval_completed_at: anyOf: - type: string format: date-time - type: 'null' title: Release Eval Completed At type: object required: - id - organization_id - suite_id - agent_id - created_at - status title: SimulationSuiteRunSummaryResponse description: >- Slim suite-run row for the org-wide list. Deliberately *not* :class:`SimulationSuiteRunResponse`: that one embeds every child run, each carrying ``inputs_snapshot`` + ``tool_overrides`` JSONB, so a 50-row page of 20-item suites serialises 1000 nested runs. This shape swaps the child array for ``counts`` and inlines ``suite_name`` so the client needs no second lookup. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError SuiteRunStatusCounts: properties: total_items: type: integer title: Total Items default: 0 pending: type: integer title: Pending default: 0 running: type: integer title: Running default: 0 completed: type: integer title: Completed default: 0 failed: type: integer title: Failed default: 0 cancelled: type: integer title: Cancelled default: 0 budget_exceeded: type: integer title: Budget Exceeded default: 0 type: object title: SuiteRunStatusCounts description: >- Per-status child-run counts for one suite-run batch. Counted over the *latest attempt per suite item* (the same dedupe :func:`aggregate_suite_run_status` uses), so a retried-away FAILED original never shows up as a failure next to a ``status="completed"`` rollup. securitySchemes: APIKeyHeader: type: apiKey in: header name: x-api-key ````