---
title: "Query agent invocation evaluations"
method: GET
path: "/agent-history/agent-invocation-evaluations"
tags: ["Agent Invocation Evaluations"]
---

# Query agent invocation evaluations

`GET /agent-history/agent-invocation-evaluations`

## Request

- Base URL: `http://localhost:8090/agent-api`
- URL: `http://localhost:8090/agent-api/agent-history/agent-invocation-evaluations`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/flowable/apis/flowable-agent-engine-rest-api/docs/agent-history/agent-invocation-evaluations/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `agentInstanceId` string
- `evaluatorKey` string
- `invocationId` string
- `kind` string
- `order` string
- `passed` boolean
- `size` integer
- `sort` string
- `start` integer
- `tenantId` string

## Response `200`

Indicates the request was successful.

- DataResponseAgentInvocationEvaluationResponse
  - `data` AgentInvocationEvaluationResponse[]
    - `id` string, required: The unique identifier for the agent invocation evaluation.
    - `invocationId` string, required: The identifier for the correlating agent invocation.
    - `agentInstanceId` string, required: The identifier for the correlating agent instance.
    - `operationKey` string: The key of the operation that the evaluation belongs to.
    - `evaluatorKey` string: The stable identity for the evaluator across runs.
    - `evaluatorSubKey` string: The operation scored by an agent/service evaluator; null for the expression kind.
    - `kind` string: The kind of the evaluation (agent, delegateExpression, service).
    - `passed` boolean: The verdict of the evaluation. Null until the evaluation completes (its endTime is set).
    - `score` number, double: The score returned by the evaluator.
    - `scoreMin` number, double: The lower bound of the score range.
    - `scoreMax` number, double: The upper bound of the score range.
    - `reason` string: The reason returned by the evaluator.
    - `referenceScopeId` string: Drill-down handle to the scope that produced the verdict (the judge agent instance for the agent kind).
    - `referenceScopeType` string: Scope type of referenceScopeId (agent for the agent kind; null otherwise).
    - `startTime` integer: The time when the evaluation was started.
    - `endTime` integer: The time when the evaluation ended.
    - `durationInMillis` integer: The duration of the evaluation in milliseconds.
  - `total` integer
  - `start` integer
  - `sort` string
  - `order` string
  - `size` integer

## Other responses

- `400`: Indicates the request had some invalid arguments.
- `403`: Indicates that the user does not have access to query agent invocation evaluations

---

[API](https://skmtc.dev/flowable/apis/flowable-agent-engine-rest-api.md) - [All operations](https://skmtc.dev/flowable/apis/flowable-agent-engine-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/flowable/apis/flowable-agent-engine-rest-api/revisions/54fc1189496f?raw)