# List Eval Runs

**GET /v2/eval-runs**

List all eval runs, with optional filtering.

Args:
    eval_uuid (str, optional): UUID of the eval to filter runs by. Defaults to None.
    workspace_uuid (str, optional): UUID of the workspace. Defaults to None.

Returns:
    list[EvalRunResult]: List of eval runs matching the filters.

Raises:
    AymaraAPIError: If the organization is missing.

Example:
    GET /api/eval-runs?eval_uuid=...&workspace_uuid=...


## Servers
- Production server (uses live data): https://api.aymara.ai (Production server (uses live data))
- Staging server (uses test data): https://staging-api.aymara.ai (Staging server (uses test data))


## Authentication methods
- Api key
- Auth bearer


## Parameters


### Query parameters
- **eval_uuid** (string)

- **workspace_uuid** (string)

- **limit** (integer)

- **offset** (integer)



## Responses
### 200
OK

#### Body: application/json (object)
- **items** (array[object])

- **count** (integer)


### 400
Bad Request

#### Body: application/json (object)
- **error** (object)
  Schema for the contents of an error response.

  This schema defines the structure of the error data inside the `error` field
  of an API error response.
- **request_id** (string)


### 401
Unauthorized

#### Body: application/json (object)
- **error** (object)
  Schema for the contents of an error response.

  This schema defines the structure of the error data inside the `error` field
  of an API error response.
- **request_id** (string)


### 403
Forbidden

#### Body: application/json (object)
- **error** (object)
  Schema for the contents of an error response.

  This schema defines the structure of the error data inside the `error` field
  of an API error response.
- **request_id** (string)


### 404
Not Found

#### Body: application/json (object)
- **error** (object)
  Schema for the contents of an error response.

  This schema defines the structure of the error data inside the `error` field
  of an API error response.
- **request_id** (string)


### 409
Conflict

#### Body: application/json (object)
- **error** (object)
  Schema for the contents of an error response.

  This schema defines the structure of the error data inside the `error` field
  of an API error response.
- **request_id** (string)


### 422
Unprocessable Entity

#### Body: application/json (object)
- **error** (object)
  Schema for the contents of an error response.

  This schema defines the structure of the error data inside the `error` field
  of an API error response.
- **request_id** (string)


### 429
Too Many Requests

#### Body: application/json (object)
- **error** (object)
  Schema for the contents of an error response.

  This schema defines the structure of the error data inside the `error` field
  of an API error response.
- **request_id** (string)


### 500
Internal Server Error

#### Body: application/json (object)
- **error** (object)
  Schema for the contents of an error response.

  This schema defines the structure of the error data inside the `error` field
  of an API error response.
- **request_id** (string)


### 503
Service Unavailable

#### Body: application/json (object)
- **error** (object)
  Schema for the contents of an error response.

  This schema defines the structure of the error data inside the `error` field
  of an API error response.
- **request_id** (string)



[Powered by Bump.sh](https://bump.sh)