---
title: "Get AI chat processing status"
method: GET
path: "/v1/ai/chat/{chat-id}/status"
tags: ["AI Chat"]
---

# Get AI chat processing status

`GET /v1/ai/chat/{chat-id}/status`

Poll for the current processing status of an AI chat session.
Returns the status (idle, processing, completed, or error) along with
any pending question, completed response, or error message.

## Path parameters

- `chat-id` integer, required

## Response `200`

Status retrieved successfully

- object
  - `status` 'idle' | 'processing' | 'completed' | 'error' — Current processing state
  - `pendingQuestion` unknown
  - `currentFunction` string, nullable — Name of the function currently being executed by AI (present when status is processing)
  - `response` string, nullable — AI response text (present when status is completed)
  - `errorMessage` string — Error description (present when status is error)

## Other responses

- `400` — Invalid chat ID
- `401` — Unauthorized
- `403` — Access denied
- `404` — Chat session not found

---

[API](https://skmtc.net/netxms/apis/netxms-api.md) · [All operations](https://skmtc.net/netxms/apis/netxms-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netxms/netxms-api/revisions/3654edb8211f/schema)