> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Bria request status

> Check Bria Image Editing progress with CometAPI Query Status API (GET /bria/{request_id}) for async image requests and results readiness.

## Overview

Retrieve the status and result of an asynchronous [Edit images with Bria](/api/image/bria/image-editing) request by its `request_id`.

<Note>
  This endpoint is only used for Bria Image Editing tasks. Use the `request_id` returned from the editing API call.
</Note>


## OpenAPI

````yaml api/openapi/image/bria/get-query-status.openapi.json GET /bria/{request_id}
openapi: 3.1.0
info:
  title: Query Status API
  version: 1.0.0
servers:
  - url: https://api.cometapi.com
security:
  - bearerAuth: []
paths:
  /bria/{request_id}:
    get:
      summary: Query Status
      description: >-
        Poll an asynchronous Bria image-editing task by `request_id`. Editing
        actions return a `request_id`; text-to-image and text-to-vector respond
        synchronously and have no task to poll. Finished tasks return `status:
        "COMPLETED"` with `result.image_url`; task-level failures return
        `status: "ERROR"` with details.
      operationId: query_status
      parameters:
        - name: request_id
          in: path
          required: true
          description: The request_id returned by the Bria Image Editing API
          schema:
            type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties: {}
              examples:
                Completed:
                  summary: Finished task
                  value:
                    result:
                      seed: 746992730
                      image_url: https://temp.bria.ai/9c4d61bbc940/<request_id>.png
                      refined_prompt: >-
                        Cliffside silhouette in a cozy living room, warm ambient
                        light.
                    status: COMPLETED
                    request_id: <request_id>
                Task error:
                  summary: Task-level failure
                  value:
                    error:
                      code: 406
                      details: >-
                        406 Not Acceptable: Increased image resolution will
                        exceed maximum dimension: 8192 pixels.
                      message: >-
                        Increased image resolution will exceed maximum
                        dimension: 8192 pixels.
                    status: ERROR
                    request_id: <request_id>
      x-codeSamples:
        - lang: Shell
          label: Default
          source: |
            REQUEST_ID="<request_id>"

            curl "https://api.cometapi.com/bria/$REQUEST_ID" \
              -H "Authorization: Bearer $COMETAPI_KEY"
        - lang: Python
          label: Default
          source: |
            import os
            import time
            import requests

            request_id = "<request_id>"
            headers = {"Authorization": "Bearer " + os.environ["COMETAPI_KEY"]}

            while True:
                task = requests.get(
                    f"https://api.cometapi.com/bria/{request_id}", headers=headers
                ).json()
                print(task.get("status"))
                if task.get("status") in ("COMPLETED", "ERROR"):
                    break
                time.sleep(5)

            if task.get("status") == "COMPLETED":
                print(task["result"]["image_url"])
        - lang: JavaScript
          label: Default
          source: >
            const requestId = "<request_id>";

            const headers = { Authorization: `Bearer
            ${process.env.COMETAPI_KEY}` };


            let task;

            while (true) {
                task = await (await fetch(`https://api.cometapi.com/bria/${requestId}`, { headers })).json();
                console.log(task.status);
                if (task.status === "COMPLETED" || task.status === "ERROR") break;
                await new Promise((resolve) => setTimeout(resolve, 5000));
            }


            if (task.status === "COMPLETED") console.log(task.result.image_url);
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Bearer token authentication. Use your CometAPI key.

````