---
title: "Returns one scan by id: queued, running, completed, completed_partial, or failed, plus engines_attempted vs engines_measured, engine errors, prompts_billed/prompts_scored, prompts_scored_count/prompts_billed_count, progress_percent, scorer_version, scores_by_engine when completed, and whether competitors, citations, and recommendations are ready. status is completed_partial when the grid is incomplete. Default view=compact hides vs_previous.cells (delta only). Pass view=full for the cell dump. While queued or running, includes last_spend from the account pool so a debit on another business is not mistaken for a silent rescan. Free. Poll this after run_scan instead of get_visibility_report."
method: GET
path: "/get_scan"
tags: ["read"]
---

# Returns one scan by id: queued, running, completed, completed_partial, or failed, plus engines_attempted vs engines_measured, engine errors, prompts_billed/prompts_scored, prompts_scored_count/prompts_billed_count, progress_percent, scorer_version, scores_by_engine when completed, and whether competitors, citations, and recommendations are ready. status is completed_partial when the grid is incomplete. Default view=compact hides vs_previous.cells (delta only). Pass view=full for the cell dump. While queued or running, includes last_spend from the account pool so a debit on another business is not mistaken for a silent rescan. Free. Poll this after run_scan instead of get_visibility_report.

`GET /get_scan`

## Request

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

## Query parameters

- `scan_id` string, uuid, required: Scan ID returned by run_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)