# Get job status

Retrieves the current status of an asynchronous request.
**Behavior**
- Under normal operation, this endpoint returns **`200 OK`**, regardless of whether the request is in progress, completed, or has failed at the job level.
- The `status` field in the response (`IN_PROGRESS`, `COMPLETED`, `ERROR`, `UNKNOWN`) indicates the state of the job.
- When the job fails (status=`ERROR`), details of the failure are provided in the `error` object, but the HTTP status remains `200`.
- When `status=COMPLETED`, `result` includes `image_url` for images or `video_url` for videos, or structured_prompt based on the original endpoint.

**Other Possible Responses**
- **`404 NOT_FOUND`** – Returned when the specified `request_id` does not exist or has expired.
- **`5XX`** – Returned when the status endpoint itself experiences an internal error.
For real-time updates, check [Bria's Status Page](https://status.bria.ai). You can also contact our [Support](mailto:support@bria.ai).
- When `status=COMPLETED`, `result` may also include:
  - `seed` – Deterministic seed used for generation (if supported by the endpoint).
  - `prompt` – Original prompt provided by the user (if applicable).
  - `refined_prompt` – System-enhanced version of the input prompt (if applicable).
  - `structured_prompt` – The detailed JSON structured prompt used for V2 generation.

Endpoint: GET /status/{request_id}
Security: api_token

## Path parameters:

  - `request_id` (string, required)
    Unique identifier of the request.

## Response 200 fields (application/json):

  - `result` (any, required)

  - `result.image_url` (string, required)

  - `result.seed` (integer)
    Deterministic generation seed (returned only for endpoints that support reproducible outputs).

  - `result.prompt` (string)
    Original prompt sent by the user (returned only if applicable).

  - `result.refined_prompt` (string)
    Refined version of the input prompt (returned only if applicable and supported by the endpoint).

  - `result.structured_prompt` (string)
    The detailed JSON structured prompt used for the V2 generation (returned only by V2 image generation and structured prompt generation endpoints).

  - `result.video_url` (string, required)

  - `result.warning` (string)
    Present only when the request was served with an adjusted parameter, explaining what was changed and why. For example, asking for a transparent background on an output preset that cannot carry alpha returns the video with a black background and a warning naming the presets that do support transparency.

  - `result.structured_prompt` (string, required)
    The JSON structured prompt (returned by the structured prompt generation endpoints).

  - `result.seed` (integer)
    Seed to pass back with the structured prompt to reproduce a generation.

  - `status` (string, required)
    Enum: "COMPLETED"

  - `request_id` (string, required)

  - `error` (object, required)

  - `error.code` (integer, required)
    Example: 123

  - `error.message` (string, required)

  - `error.details` (string, required)

## Response 404 fields (application/json):

  - `status` (string, required)
    Enum: "NOT_FOUND"

## Response 5XX fields (application/json):

  - `error` (object, required)

  - `error.code` (integer, required)
    Example: 123

  - `error.message` (string, required)

  - `error.details` (string, required)

  - `request_id` (string, required)