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

# Get an ad visibility analysis

> Retrieve the status and ad visibility score of a submitted ad analysis.

Retrieve an ad visibility analysis by its `id`. Poll until `status` is `success` or `failed`. On success, `outputs` contains the visibility `score` and a link to the input ad image. Analyses become unavailable one hour after completion, returning `410 Gone` (see [Result expiry](/concepts/result-expiry)).

<ParamField path="id" type="string" required>
  The request ID returned when the ad visibility job was created.
</ParamField>

<ResponseField name="id" type="string">
  The analysis identifier.
</ResponseField>

<ResponseField name="status" type="string">
  The current state: `pending`, `success`, or `failed`.
</ResponseField>

<ResponseField name="outputs" type="object">
  Present when `status` is `success`. Contains the ad visibility `score` and the `input` image URL.
</ResponseField>

<ResponseField name="error" type="object">
  Present when `status` is `failed`. Contains an error `code` and `message`.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl \
    -H "Authorization: Bearer $apikey" \
    -H "Content-Type: application/json" \
    -X GET \
    https://api.eyequant.com/v2/ad-visibility/611457618c1d4283a830d10a9ad4f8ae
  ```
</RequestExample>

<ResponseExample>
  ```json pending theme={null}
  { "id": "611457618c1d4283a830d10a9ad4f8ae", "status": "pending" }
  ```

  ```json success theme={null}
  {
    "id": "611457618c1d4283a830d10a9ad4f8ae",
    "status": "success",
    "outputs": {
      "score": 78,
      "input": "https://s3.amazonaws.com/api-eyequant/..."
    }
  }
  ```

  ```json failed theme={null}
  {
    "id": "611457618c1d4283a830d10a9ad4f8ae",
    "status": "failed",
    "error": {
      "code": "unreadable_input_image",
      "message": "We were unable to read the input image, either because the format is not supported, or because the image is truncated or corrupted."
    }
  }
  ```
</ResponseExample>