---
title: "Get report status"
method: GET
path: "/api/v1/domain-burn/scan-score"
tags: ["Domain Burn Alerts"]
---

# Get report status

`GET /api/v1/domain-burn/scan-score`

## Request

- Base URL: `https://api.aerosend.io`
- URL: `https://api.aerosend.io/api/v1/domain-burn/scan-score`
- Auth: API key in header `X-API-Key`

Same status object as `data.scan` on GET /domain-burn.
Status is NOT_STARTED, IN_PROGRESS, COMPLETED or FAILED; `next_step` drives the UI flow.
Pass `id` from GET /keys for that key's status; omit it for the client-wide status.

## Query parameters

- `id` integer

## Response `200`

Current report status

- ScanScoreApiResponse
  - `success` boolean: Success flag
  - `data` ScanScore: Domain Burn scan / report status for the authenticated client
    - `status` 'NOT_STARTED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED': Scan / report status
    - `reportExists` boolean: True when a completed report is available (possibly from an earlier scan)
    - `nextStep` 'CONNECT_SEQUENCER' | 'WAIT' | 'VIEW_REPORT' | 'RETRY_SCAN': What the UI should do next
    - `message` string: Human readable explanation of the status
    - `startedAt` string, date-time: When the latest scan was started
    - `completedAt` string, date-time: When the latest report was produced
    - `sequencers` SequencerInfo[]: Connected sequencers (keys are never returned)
      - `sequencer` string
      - `connected` boolean
      - `accountCount` integer: Number of active API keys for this sequencer
      - `scanSupported` boolean: False when DBA ingestion cannot scan this sequencer yet
  - `timestamp` string: Response timestamp

## Other responses

- `401`: Unauthorized - Invalid or expired API key
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/aerosend/apis/aerosend-developer-api.md) · [All operations](https://skmtc.dev/aerosend/apis/aerosend-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aerosend/apis/aerosend-developer-api/revisions/9828eeb89b1f?raw)