---
title: "Returns the current AI visibility score. Default view=compact is score, scores_by_engine (0–100 recommendation share per engine, null when not_measured), scorer_version, engines attempted/measured, mention-kind counts, cite_kind_split (ours/other), derived issues, and trend points with scorer_version. Pass view=full for the per-engine dump. Failed engines are not_measured and excluded from the score. Issues cannot contradict an engine that appeared. If the business has no scan yet, returns a structured no_scan payload with next: [run_scan]. Use when the user asks how visible they are in AI search."
method: GET
path: "/get_visibility_report"
tags: ["read"]
---

# Returns the current AI visibility score. Default view=compact is score, scores_by_engine (0–100 recommendation share per engine, null when not_measured), scorer_version, engines attempted/measured, mention-kind counts, cite_kind_split (ours/other), derived issues, and trend points with scorer_version. Pass view=full for the per-engine dump. Failed engines are not_measured and excluded from the score. Issues cannot contradict an engine that appeared. If the business has no scan yet, returns a structured no_scan payload with next: \[run_scan\]. Use when the user asks how visible they are in AI search.

`GET /get_visibility_report`

## Request

- Base URL: `https://scope.online/v1`
- URL: `https://scope.online/v1/get_visibility_report`
- Auth: HTTP bearer

## Query parameters

- `business_id` string, uuid, required: Owned Scope business ID
- `scan_id` string, uuid: Optional scan id (error/partial/completed). Defaults to latest headline scan.
- `view` 'compact' | 'full'

## Response `200`

Tool payload. `meta` holds tldr, next[], pagination cursors, and request_id.

## Other responses

- `400`: Invalid request.
- `401`: Missing or invalid API key.
- `402`: Quota or over-committed.
- `403`: Missing scope or Growth required.
- `404`: Unknown tool or resource.
- `405`: Wrong HTTP method for this tool.
- `429`: Rate limited (10 action calls / 60s per key; reads are higher).
- `503`: Temporary infrastructure limit — retry with retry_after.

---

[API](https://skmtc.dev/scope/apis/scope-api-2.md) · [All operations](https://skmtc.dev/scope/apis/scope-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/scope/apis/scope-api-2/revisions/2f01893f6e5c?raw)