---
title: "Get burn detail for one domain"
method: GET
path: "/api/v1/domain-burn/domains/{domain}"
tags: ["Domain Burn Alerts"]
---

# Get burn detail for one domain

`GET /api/v1/domain-burn/domains/{domain}`

## Request

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

Metrics, issues, monthly score history and the recommended action for a domain.
Pass `id` from GET /keys to require that the domain belongs to that sequencer key.

## Path parameters

- `domain` string, required

## Query parameters

- `id` integer

## Response `200`

Domain burn detail

- DomainBurnDetailApiResponse
  - `success` boolean: Success flag
  - `data` DomainBurnDomainDetail: Health detail for a single domain
    - `domain` DomainBurnDomain
      - `domain` string
      - `status` string
      - `burnScore` integer: Burn score (0-100); null when low-volume
      - `sent` integer: Emails sent in the scored period
      - `delta` integer: Score change vs previous period
      - `flags` string[]
      - `clientName` string
      - `metricsDate` string, date
    - `sequencer` string: Display name of the sequencer(s) the domain is scored from
    - `metrics` DomainBurnMetrics
      - `burnScore` number, double
      - `warmupScore` number, double
      - `replyRate` number, double: Reply rate (%)
      - `bounceRate` number, double: Bounce rate (%)
      - `placementScore` number, double: Inbox placement (%)
      - `totalSent` integer
      - `metricsDate` string, date
    - `issues` DomainBurnIssue[]: Why the domain is in its bucket; empty for good/excellent/low-volume
      - `tag` string
      - `text` string
    - `history` DomainBurnHistoryPoint[]: Monthly burn score history, oldest first
      - `month` string
      - `label` string
      - `score` integer
    - `action` DomainBurnAction
      - `type` string
      - `title` string
      - `description` string
      - `buttonLabel` string
    - `notice` string: Shown instead of history for low-volume domains
  - `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)