# API: Domains

> Domains operations of the Maildeck API: list_domains, get_domain_health.

Source: https://docs.maildeck.co/api/domains/

[← API overview](https://docs.maildeck.co/api/)

## list_domains

`GET /v1/domains` · scope: **read** · MCP tool: `list_domains`

The domains on this account, with provider, inbox count and status.

status is "active" once inboxes are delivered on the domain and "setup" while it is being built.

```bash
curl -X GET "https://api.maildeck.co/v1/domains" \
  -H "Authorization: Bearer $MAILDECK_API_KEY"
```

## get_domain_health

`GET /v1/domains/health` · scope: **read** · MCP tool: `get_domain_health`

Blacklist monitoring and mail-record health (MX, SPF, DKIM, DMARC) for each domain.

Per domain: which blacklists list it, since when, when it was last checked, and its mail-record posture. A domain on Spamhaus should be replaced: see check_replacement_domains and request_domain_replacements. SURBL alone is not urgent.

| Parameter | In | Type | Required | Notes |
|---|---|---|---|---|
| `domain` | query | string | no | Return only this domain. up to 253 chars |

```bash
curl -X GET "https://api.maildeck.co/v1/domains/health" \
  -H "Authorization: Bearer $MAILDECK_API_KEY"
```
