---
title: "Retrieve the current status of a previously submitted asyncquery given its job_id"
method: GET
path: "/asyncquery_status/{job_id}"
tags: ["asyncquery_status"]
---

# Retrieve the current status of a previously submitted asyncquery given its job_id

`GET /asyncquery_status/{job_id}`

## Path parameters

- `job_id` string, required

## Response `200`

Returns the status and current logs of a previously submitted asyncquery.

- AsyncQueryStatusResponse — The AsyncQueryStatusResponse object contains a payload that describes the current status of a previously submitted async_query.
  - `status` string, required — One of a standardized set of short codes: Queued, Running, Completed, Failed
  - `description` string, required — A brief human-readable description of the current state or summary of the problem if the status is Failed.
  - `logs` LogEntry[], required — A list of LogEntry items, containing errors, warnings, debugging information, etc. List items MUST be in chronological order with earliest first. The most recent entry should be last. Its timestamp will be compared against the current time to see if there is still activity.
    - `timestamp` string, date-time, required — Timestamp in ISO 8601 format, providing the LogEntry time either in univeral coordinated time (UTC) using the 'Z' tag (e.g 2020-09-03T18:13:49Z), or, if local time is provided, the timezone offset must be provided (e.g. 2020-09-03T18:13:49-04:00).
    - `level` 'ERROR' | 'WARNING' | 'INFO' | 'DEBUG' — Logging level
    - `code` string, nullable — One of a standardized set of short codes e.g. QueryNotTraversable, KPNotAvailable, KPResponseMalformed
    - `message` string, required — A human-readable log message
  - `response_url` string, nullable — Optional URL that can be queried to restrieve the full TRAPI Response.

## Other responses

- `404` — job_id not found
- `501` — Return code 501 indicates that this endpoint has not been implemented at this site. Sites that implement /asyncquery MUST implement /asyncquery_status/{job_id}, but those that do not implement /asyncquery SHOULD NOT implement /asyncquery_status.

---

[API](https://skmtc.net/rtxteam/apis/rtx-kg2-trapi-1-5-0.md) · [All operations](https://skmtc.net/rtxteam/apis/rtx-kg2-trapi-1-5-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rtxteam/rtx-kg2-trapi-1-5-0/versions/e65b311ece6d/schema)