---
title: "List agent simulation runs"
method: GET
path: "/api/v1/agent-simulation/runs"
tags: ["Simulations"]
---

# List agent simulation runs

`GET /api/v1/agent-simulation/runs`

## Request

- Base URL: `https://app.promptingco.com`
- URL: `https://app.promptingco.com/api/v1/agent-simulation/runs`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer
  - API key in cookie `better-auth.session_token`

## Query parameters

- `environmentId` string
- `taskId` string
- `experimentId` string
- `iterationId` string
- `status` string
- `search` string
- `page` integer
- `pageSize` integer
- `orderBy` 'task' | 'environment' | 'iterationId' | 'status' | 'overallScore' | 'duration' | 'completedAt' | 'createdAt'
- `order` 'asc' | 'desc'

## Response `200`

Successful response

- object
  - `ok` true, required
  - `data` object, required
    - `runs` object[], required
      - `id` string, required
      - `environmentId` string, required
      - `taskId` string, nullable, required
      - `organizationId` string, required
      - `status` string, required
      - `sandboxId` string, nullable, required
      - `sandboxSnapshot` string, nullable, required
      - `volumeIds` unknown
      - `logS3Keys` unknown
      - `overallScore` number, nullable, required
      - `passed` boolean, nullable, required
      - `tokensUsed` integer, nullable, required
      - `costUsd` number, nullable, required
      - `metadata` unknown
      - `startedAt` string, date-time, nullable, required
      - `completedAt` string, date-time, nullable, required
      - `duration` integer, nullable, required
      - `createdAt` string, date-time, required
      - `updatedAt` string, date-time, required
      - `deletedAt` string, date-time, nullable, required
      - `environment` object, nullable
        - `id` string, required
        - `name` string, required
        - `agentConfig` unknown
        - `task` object, nullable
          - `id` string, required
          - `name` string, required
          - `category` string, required
      - `task` object, nullable
        - `id` string, required
        - `name` string, required
        - `category` string, required
    - `total` integer, required

## Other responses

- `400`: Bad request
- `401`: Authentication required
- `403`: Forbidden
- `404`: Not found
- `422`: Validation failed
- `500`: Internal server error

---

[API](https://skmtc.dev/promptingcompany/apis/the-prompting-company-api.md) - [All operations](https://skmtc.dev/promptingcompany/apis/the-prompting-company-api/llms.txt) - [OpenAPI document](https://skmtc.dev/promptingcompany/apis/the-prompting-company-api/revisions/c0451ea10e9a?raw)