---
title: "Query Async Job Status"
method: GET
path: "/query/v1alpha1/jobs/{statement_id}/status"
tags: ["Statements (query/v1alpha1)"]
---

# Query Async Job Status

`GET /query/v1alpha1/jobs/{statement_id}/status`

Returns status updates containing the explicit operational lifecycle states of an active background query.

## Path parameters

- `statement_id` string, required

## Response `200`

State evaluated successfully.

- QueryV1alpha1JobStatusResponse — Lifecycle state of a statement running in the background.
  - `status` QueryV1alpha1JobStatus, required — The status of the background statement.
    - `phase` string, required — The lifecycle phase of the background statement: PENDING: statement is queued and has not started executing; RUNNING: statement execution is in progress; COMPLETED: statement finished successfully and its results are retrievable; FAILED: statement execution failed; see `errors` for details.
  - `errors` Error[] — Failure details for the background statement. Populated only when `status.phase` is `FAILED`; omitted otherwise.
    - `id` string — A unique identifier for this particular occurrence of the problem.
    - `status` string — The HTTP status code applicable to this problem, expressed as a string value.
    - `code` string — An application-specific error code, expressed as a string value.
    - `title` string — A short, human-readable summary of the problem. It **SHOULD NOT** change from occurrence to occurrence of the problem, except for purposes of localization.
    - `detail` string — A human-readable explanation specific to this occurrence of the problem.
    - `source` object — If this error was caused by a particular part of the API request, the source will point to the query string parameter or request body property that caused it.
      - `pointer` string — A JSON Pointer [RFC6901] to the associated entity in the request document [e.g. "/spec" for a spec object, or "/spec/title" for a specific field].
      - `parameter` string — A string indicating which query parameter caused the error.
    - `error_code` integer
    - `message` string, nullable

## Other responses

- `400` — Bad Request
- `401` — The request lacks valid authentication credentials for this resource.
- `403` — The access credentials were considered insufficient to grant access
- `429` — Rate Limit Exceeded
- `500` — Oops, something went wrong!

---

[API](https://skmtc.dev/confluent/apis/confluent-cloud-apis.md) · [All operations](https://skmtc.dev/confluent/apis/confluent-cloud-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/confluent/confluent-cloud-apis/revisions/a6a73f98a698/schema)
