# Query the task status (/en/api-reference/api-ref/speech-to-text/query)

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

Queries the status of a Real-time STT task.

- OpenAPI: /openapi/speech-to-text/v7.en.yaml
- Operation ID: query
- Method: GET
- Path: /api/speech-to-text/v1/projects/{appid}/agents/{agentId}

## Servers

- https://api.agora.io

## Parameters

- `appid` (path, required) - The App ID of the project.
- `agentId` (path, required) - The unique identifier of the agent you received in the response body of the `join` method.

## Request body

No request body.

## Responses

### 200

OK

- `message` (string) - Details of the request result
No schema.
- `agent_id` (string) - The ID of the agent.
No schema.
- `create_ts` (integer) - The Unix timestamp (in seconds) when the transcription task was created.
No schema.
- `status` (string) - The current status of the agent:
- `IDLE`: The agent is not initialized
- `STARTING`: The agent is starting
- `RUNNING`: The agent is running
- `STOPPING`: The agent is exiting
- `STOPPED`: The agent exited successfully
- `RECOVERING`: The agent is recovering
- `FAILED`: Agent exit failed
No schema.
### default

Error response.

- `message` (string) - Details of the failed request.
No schema.
- `agent_id` (string) - The ID of the agent.
No schema.
- `create_ts` (integer) - The Unix timestamp (in seconds) when the transcription task was created.
No schema.
- `status` (string) - The status of the agent. If the returned status code is not 200, the request failed. Troubleshoot according to the `details` and `reason` fields.
No schema.