> ## Documentation Index > Fetch the complete documentation index at: https://penseapp.vercel.app/docs/llms.txt > Use this file to discover all available pages before exploring further. # List agent evaluators > List evaluators linked to an agent ## OpenAPI ````yaml /api-reference/openapi.json get /agents/{agent_uuid}/evaluators openapi: 3.1.0 info: title: Calibrate Public API version: 0.1.0 description: Programmatic API for CI/automation. Pass your key in the `X-API-Key` header. servers: - url: https://api.calibrate.artpark.ai description: Production security: [] paths: /agents/{agent_uuid}/evaluators: get: tags: - agents summary: List agent evaluators description: List evaluators linked to an agent operationId: list_agent_evaluators_agents__agent_uuid__evaluators_get parameters: - name: agent_uuid in: path required: true schema: type: string description: The agent whose evaluators to list examples: - f47ac10b-58cc-4372-a567-0e02b2c3d479 title: Agent Uuid description: The agent whose evaluators to list - name: q in: query required: false schema: anyOf: - type: string - type: 'null' description: Case-insensitive substring search on `name`. Blank is a no-op title: Q description: Case-insensitive substring search on `name`. Blank is a no-op - name: limit in: query required: false schema: anyOf: - type: integer maximum: 1000000 minimum: 1 - type: 'null' description: Maximum number of items to return. Omit for no limit (all items) title: Limit description: Maximum number of items to return. Omit for no limit (all items) - name: offset in: query required: false schema: type: integer minimum: 0 description: Number of items to skip before returning results default: 0 title: Offset description: Number of items to skip before returning results responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/PaginatedResponse_EvaluatorResponse_' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - ApiKeyAuth: [] components: schemas: PaginatedResponse_EvaluatorResponse_: properties: items: items: $ref: '#/components/schemas/routers__evaluators__EvaluatorResponse' type: array title: Items description: The page of results total: type: integer title: Total description: Total number of items matching the query, before pagination limit: anyOf: - type: integer - type: 'null' title: Limit description: The applied `limit` (null when unbounded) offset: type: integer title: Offset description: The applied `offset` default: 0 type: object required: - items - total title: PaginatedResponse[EvaluatorResponse] HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError routers__evaluators__EvaluatorResponse: properties: uuid: type: string maxLength: 36 minLength: 36 title: Uuid description: Evaluator ID examples: - f47ac10b-58cc-4372-a567-0e02b2c3d479 name: type: string title: Name description: Evaluator name description: anyOf: - type: string - type: 'null' title: Description description: What the evaluator checks evaluator_type: type: string enum: - tts - stt - llm - llm-general - conversation title: Evaluator Type description: | What the evaluator judges: - `tts`: TTS audio - `stt`: one transcript - `llm`: a reply with its conversation history - `llm-general`: a standalone input and output pair - `conversation`: a full conversation data_type: type: string enum: - text - audio title: Data Type description: | The modality the judge reads: - `text` - `audio` output_type: type: string enum: - binary - rating title: Output Type description: | How the evaluator scores: - `binary`: pass or fail - `rating`: a numeric score, using the scale in `output_config` is_default: type: boolean title: Is Default description: >- True when the evaluator is a built-in default or your workspace's editable copy of one. False for an evaluator you created yourself slug: anyOf: - type: string - type: 'null' title: Slug description: Stable slug for a built-in default evaluator source_default_slug: anyOf: - type: string - type: 'null' title: Source Default Slug description: >- Stable slug of the built-in default this evaluator is your editable copy of. Set on your default forks so you can identify a specific default by it live_version_id: anyOf: - type: string maxLength: 36 minLength: 36 - type: 'null' title: Live Version Id description: ID of the version that is currently live examples: - 6ba7b810-9dad-11d1-80b4-00c04fd430c8 created_at: type: string title: Created At description: When the evaluator was created (ISO 8601 UTC) updated_at: type: string title: Updated At description: When the evaluator was last updated (ISO 8601 UTC) live_version: anyOf: - $ref: '#/components/schemas/EvaluatorLiveVersionSummary' - type: 'null' description: The version that is currently live type: object required: - uuid - name - evaluator_type - data_type - output_type - is_default - created_at - updated_at title: EvaluatorResponse ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError EvaluatorLiveVersionSummary: properties: uuid: type: string maxLength: 36 minLength: 36 title: Uuid description: Version ID examples: - 6ba7b810-9dad-11d1-80b4-00c04fd430c8 version_number: type: integer title: Version Number description: >- The version's number. The first version is 1, and it goes up by one for each new version of the evaluator judge_model: type: string title: Judge Model description: >- The model that runs the judge, named the way its provider does, for example `openai/gpt-4.1` or `anthropic/claude-sonnet-4` variables: anyOf: - items: $ref: '#/components/schemas/VariableSpec' type: array - type: 'null' title: Variables description: Declared prompt variables type: object required: - uuid - version_number - judge_model title: EvaluatorLiveVersionSummary description: >- Slim view of the live version for list results, carrying only what the list needs. VariableSpec: properties: name: type: string title: Name description: Name of a `{{placeholder}}` used in the system prompt description: anyOf: - type: string - type: 'null' title: Description description: What the variable is for. Omit if self-evident default: anyOf: - type: string - type: 'null' title: Default description: Default value used when you omit this variable. Omit for no default type: object required: - name title: VariableSpec securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: API key for authentication ````