---
title: "Get async chat completion job"
method: GET
path: "/v1/async/chat/completions/{job_id}"
tags: ["Async Jobs"]
---

# Get async chat completion job

`GET /v1/async/chat/completions/{job_id}`

## Request

- Base URL: `http://localhost:8080`
- URL: `http://localhost:8080/v1/async/chat/completions/{job_id}`
- Auth: one of:
  - HTTP bearer
  - HTTP basic
  - API key in header `x-bf-vk`
  - API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/getbifrost/apis/bifrost-api/docs/v1/async/chat/completions/:job_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the status and result of an async chat completion job.
Returns HTTP 202 if the job is still pending or processing, HTTP 200 if completed or failed.

## Path parameters

- `job_id` string, required

## Response `200`

Job completed (successfully or with failure)

- AsyncJobResponse: Response returned when creating or polling an async job
  - `id` string, required: Unique identifier for the async job
  - `status` 'pending' | 'processing' | 'completed' | 'failed', required: The status of an async job
  - `expires_at` string, date-time: When the job result expires and will be cleaned up
  - `created_at` string, date-time, required: When the job was created
  - `completed_at` string, date-time: When the job completed (successfully or with failure)
  - `status_code` integer: HTTP status code of the completed operation
  - `result` unknown
  - `error` BifrostError: Error response from Bifrost
    - `event_id` string
    - `type` string
    - `is_bifrost_error` boolean
    - `status_code` integer
    - `error` ErrorField
      - `type` string
      - `code` string
      - `message` string
      - `param` string
      - `event_id` string
    - `extra_fields` BifrostErrorExtraFields
      - `provider` 'openai' | 'azure' | 'anthropic' | 'bedrock' | 'cohere' | 'vertex' | 'vllm' | 'mistral' | 'ollama' | 'groq' | 'sgl' | 'parasail' | 'perplexity' | 'replicate' | 'cerebras' | 'deepseek' | 'gemini' | 'openrouter' | 'elevenlabs' | 'huggingface' | 'nebius' | 'xai' | 'runway' | 'fireworks': AI model provider identifier
      - `model_requested` string
      - `request_type` string

## Other responses

- `202`: Job is still pending or processing
- `404`: Job not found or expired

---

[API](https://skmtc.dev/getbifrost/apis/bifrost-api.md) - [All operations](https://skmtc.dev/getbifrost/apis/bifrost-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getbifrost/apis/bifrost-api/revisions/f8cab88f64ea?raw)