Domain Burn Alerts

Get the domain burn report

Returns summary counts (total, burnt, at-risk, good, excellent, low-volume), status groups, end clients derived from redirect URLs, and one row per domain.

Without id, this is the entire customer report. With id from GET /keys, the report is limited to domains on that Smartlead or Instantly key (customer_integrations.mb_integration_id → client_integrations.id).

data.scan is the same status object as GET /scan-score (NOT_STARTED, IN_PROGRESS, COMPLETED, FAILED and next_step). When no report exists yet, report_available is false and scan.next_step tells the UI whether to connect a sequencer, generate the report, or wait.

get/api/v1/domain-burn

Request

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

Query parameters

idinteger

client_integrations.id from GET /keys; omit for the entire report

offsetinteger
limitinteger

Response

Domain burn report with summary counts and per-domain rows

successboolean

Success flag

timestampstring

Response timestamp

Example response

{
  "success": true,
  "data": {
    "scan": {
      "status": "COMPLETED",
      "nextStep": "VIEW_REPORT",
      "sequencers": [
        {
          "sequencer": "smartlead"
        }
      ]
    },
    "groups": [
      {
        "status": "at-risk",
        "label": "At-risk",
        "action": "slowdown",
        "actionLabel": "Slow down all"
      }
    ],
    "clients": [
      {
        "id": "acme-com",
        "name": "acme.com",
        "color": "#7B61FF"
      }
    ],
    "domains": [
      {
        "domain": "outreach-acme.com",
        "status": "burnt"
      }
    ],
    "pagination": {
      "limit": 100,
      "total": 250,
      "hasMore": true
    }
  },
  "timestamp": "2025-12-14T10:30:00Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.