---
title: "Get the status of an async request."
method: GET
path: "/async_request/{request_id}"
---

# Get the status of an async request.

`GET /async_request/{request_id}`

Returns the current status of an async model or chain request. Rate limited to 20 requests per second.

## Path parameters

- `request_id` string, required

## Response `200`

Current status of an async request.

- AsyncRequestStatusResponse
  - `request_id` string, required — The ID of the async request.
  - `model_id` string — The ID of the model that executed the request. Present for model requests.
  - `chain_id` string — The ID of the chain that executed the request. Present for chain requests.
  - `deployment_id` string, required — The ID of the deployment that executed the request.
  - `status` 'QUEUED' | 'IN_PROGRESS' | 'SUCCEEDED' | 'FAILED' | 'EXPIRED' | 'CANCELED' | 'WEBHOOK_FAILED', required — The status of the async request.
  - `webhook_status` 'PENDING' | 'SUCCEEDED' | 'FAILED' | 'CANCELED' | 'NO_WEBHOOK_PROVIDED', required — The status of sending the prediction result to the provided webhook.
  - `created_at` string, required — The time in UTC at which the async request was created.
  - `status_at` string, required — The time in UTC at which the async request's status was last updated.
  - `errors` AsyncRequestError[], required — Errors that occurred while processing the async request. Empty if no errors occurred.
    - `code` 'MODEL_PREDICT_ERROR' | 'MODEL_PREDICT_TIMEOUT' | 'MODEL_NOT_READY' | 'MODEL_DOES_NOT_EXIST' | 'MODEL_UNAVAILABLE' | 'MODEL_INVALID_INPUT' | 'ASYNC_REQUEST_NOT_SUPPORTED' | 'INTERNAL_SERVER_ERROR', required — The type of error that occurred.
    - `message` string, required — Details of the error.

## Other responses

- `401` — Error response.
- `429` — Error response.

---

[API](https://skmtc.net/baseten/apis/baseten-inference-api.md) · [All operations](https://skmtc.net/baseten/apis/baseten-inference-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/baseten/baseten-inference-api/versions/a55a2f64c3c5/schema)