# Overview

The **Status Service** provides progress tracking for asynchronous requests. This functionality is supported exclusively for **V2 endpoints**.

### Workflow
1. Submit a request with `sync=false` (default behavior).
2. The API returns a `status_url` and a `request_id`.
3. Continuously poll the `status_url` (or use the `/status/{request_id}` endpoint) until the `status` field indicates a terminal state.

### Status Values
- **`IN_PROGRESS`** – The request has been accepted and is currently being processed.  
  Continue polling until the status changes to either `COMPLETED` or an error state.

- **`COMPLETED`** – The request was successfully processed.  
  The response includes the `result.image_url` containing the generated image.  
  For some endpoints, additional optional fields (`seed`, `prompt`, `refined_prompt`) may be included.

- **`ERROR`** – A processing error occurred in the pipeline.  
  The response includes an `error` object with details about the failure. Polling should be stopped.

- **`UNKNOWN`** – An unexpected internal error occurred (equivalent to an HTTP `500` in asynchronous workflows).  
  This status should not occur under normal circumstances. If it does, contact [Support](mailto:support@bria.ai). and provide the `request_id`.



## Servers

```
https://engine.prod.bria-api.com/v2
```

## Download OpenAPI description

[Overview](https://docs.bria.ai/_spec/status.yaml)

## Endpoints

### Get Request Status

 - [GET /status/{request_id}](https://docs.bria.ai/status/endpoints/get_status.md): Retrieves the current status of an asynchronous request.

  
- Under normal operation, this endpoint returns , regardless of whether the request is in progress, completed, or has failed at the job level.  
- The  field in the response (, , , ) indicates the state of the job.  
- When the job fails (status=), details of the failure are provided in the  object, but the HTTP status remains .


-  – Returned when the specified  does not exist or has expired.  
-  – Returned when the Status Service itself experiences an internal error.
  For real-time updates, check Bria's Status Page. You can also contact our Support.

- When ,  may also include:
  -  – Deterministic seed used for generation (if supported by the endpoint).
  -  – Original prompt provided by the user (if applicable).
  -  – System-enhanced version of the input prompt (if applicable).