---
title: "Get historic agent instance details"
method: GET
path: "/agent-history/historic-agent-instances/{agentInstanceId}"
tags: ["Historic Agent Instances"]
---

# Get historic agent instance details

`GET /agent-history/historic-agent-instances/{agentInstanceId}`

## Request

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

## Path parameters

- `agentInstanceId` string, required

## Response `200`

Indicates the request was successful.

- HistoricAgentInstanceResponse: The response for a historic agent instance
  - `id` string, required: The unique identifier of a historic agent instance
  - `agentDefinitionId` string, required: The id of the agent definition that was used to start the historic agent instance.
  - `agentDefinitionKey` string, required: The key of the agent definition that was used to start the historic agent instance.
  - `agentDefinitionName` string, required: The name of the agent definition that was used to start the historic agent instance.
  - `referenceId` string: The id of the CMMN or BPMN model backing the historic agent instance behavior.
  - `referenceType` string: The type of the model that backs the historic agent instance behavior (e.g. CMMN or BPMN).
  - `callbackId` string: The callback identifier for this agent instance.
  - `callbackType` string: The callback type for this agent instance.
  - `callbackScopeId` string: The callback scope id for this agent instance.
  - `state` string: The current state of this agent instance.
  - `startTime` integer, required: The time the instance was started.
  - `endTime` integer, required: The time the instance was ended.
  - `startUserId` string: The user that started the agent instance.
  - `jsonInvocationResult` JsonNode
    - `string` boolean
    - `valueNode` boolean
    - `missingNode` boolean
    - `short` boolean
    - `double` boolean
    - `bigDecimal` boolean
    - `bigInteger` boolean
    - `textual` boolean
    - `boolean` boolean
    - `container` boolean
    - `object` boolean
    - `binary` boolean
    - `number` boolean
    - `nodeType` 'ARRAY' | 'BINARY' | 'BOOLEAN' | 'MISSING' | 'NULL' | 'NUMBER' | 'OBJECT' | 'POJO' | 'STRING'
    - `long` boolean
    - `pojo` boolean
    - `int` boolean
    - `integralNumber` boolean
    - `floatingPointNumber` boolean
    - `array` boolean
    - `empty` boolean
    - boolean
    - `float` boolean
    - `embeddedValue` boolean
  - `plainTextInvocationResult` string

## Other responses

- `400`: Indicates the request had some invalid arguments.
- `403`: Indicates that the user does not have access to the historic agent instance.
- `404`: Indicates that agent instance does not exist or the user does not have access to it.

---

[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)