# Query agent status (/en/api-reference/api-ref/conversational-ai/query)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

Retrieves the current status of a specified Conversational AI agent instance.

- OpenAPI: /openapi/conversational-ai/rest-api.en.yaml
- Operation ID: query-agent-status
- Method: GET
- Path: /v2/projects/{appid}/agents/{agentId}

## Servers

- https://api.agora.io/api/conversational-ai-agent

## Parameters

- `appid` (path, required) - The App ID of the project.
- `agentId` (path, required) - The agent instance ID you obtained after successfully calling `join` to [Start a conversational AI agent](/en/api-reference/api-ref/conversational-ai/join).

## Request body

No request body.

## Responses

### 200

The request was successful. The response body contains the result of the request.

- `message` (string) - Request message.
No schema.
- `start_ts` (integer) - Agent creation timestamp.
No schema.
- `stop_ts` (integer) - Agent stop timestamp.
No schema.
- `name` (string) - The agent name provided when calling [Start a conversational AI agent](/en/api-reference/api-ref/conversational-ai/join). Unique within a channel.
No schema.
- `status` (string) - Current status.
`IDLE` (0): Agent is idle.
`STARTING` (1): The agent is being started.
`RUNNING` (2): The agent is running.
`STOPPING` (3): The agent is stopping.
`STOPPED` (4): The agent has exited.
`FAILED` (6): The agent failed to execute.
No schema.
- `agent_id` (string) - Unique id of the agent instance
No schema.
### default

The request failed. The response body includes the error details.

- `detail` (string) - Detailed error information.
No schema.
- `reason` (string) - The reason for the failure.
No schema.