---
title: "List Eval Configurations"
method: GET
path: "/v1/api-performance/evals"
tags: ["Eval Configuration"]
---

# List Eval Configurations

`GET /v1/api-performance/evals`

## Request

- Base URL: `https://api.lightsage.com`
- URL: `https://api.lightsage.com/v1/api-performance/evals`
- Auth: API key in header `X-Lightsage-Api-Key`

Returns all eval configurations matching the optional source and enabled filters. Configurations for user-created evals are included when `source_id` is omitted and have `source_id` set to null.

## Query parameters

- `source_id` string
- `enabled` boolean

## Response `200`

Successful Response

- PublicEvalDefinitionsResponse
  - `data` PublicEvalDefinition[], required
    - `id` string, required
    - `operation_id` string, required: For a user-created eval, equals the eval ID when `source_id` is null.
    - `source_id` string, nullable: Null for a user-created eval configuration.
    - `source` PublicApiPerformanceSourceRef
      - `id` string, required
      - `type` string, nullable: The source type: `rest_api`, `python_sdk`, `node_sdk`, or `cli`.
      - `label` string, nullable
    - `eval_type` string, required
    - `prompt` string, nullable
    - `custom_prompt` string, nullable: Overrides `prompt` when set.
    - `expected_behavior` string, nullable: Deprecated compatibility view of the primary judge criterion. Use `graders` for the canonical configuration.
    - `graders` PublicGraderDefinition[]: Canonical grader definitions used to score the eval.
      - `name` string, required
      - `type` string, required
      - `needle` string, nullable
      - `needles` string[], nullable
      - `pattern` string, nullable
      - `case_sensitive` boolean
      - `criteria` string, nullable
      - `weight` number
      - `blocking` boolean
    - `starting_project_id` string, nullable
    - `docs_mode` 'default' | 'include' | 'exclude': `include` adds the organization's docs to the agent's context; `exclude` withholds them.
    - `include_env_vars` boolean: Names only, never values.
    - `env_profile_ids` string[]
    - `model_ids` string[]: Empty means the config-level models are used.
    - `compare_skills` boolean: Whether to run an additional comparison with skill context enabled.
    - `skills_mode` 'none' | 'all' | 'selected': `selected` uses `skill_ids`; `all` uses every skill; `none` supplies no skill context.
    - `skills_enabled` boolean
    - `skill_ids` string[]
    - `mcp_enabled` boolean
    - `search_grounding` 'disabled' | 'enabled' | 'default': Requested web-retrieval behavior for an eval run.
    - `grounding_enabled` boolean: Whether native web search and URL retrieval tools are available to the agent. When false, configured brand docs are also withheld.
    - `run_context` object
    - `enabled` boolean
  - `meta` object: Carries `count`.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/usesapient/apis/sapient-public-api.md) - [All operations](https://skmtc.dev/usesapient/apis/sapient-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usesapient/apis/sapient-public-api/revisions/14890dfe867e?raw)