Skip to content

API: Domains

← API overview

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.

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

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.

ParameterInTypeRequiredNotes
domainquerystringnoReturn only this domain. up to 253 chars
Terminal window
curl -X GET "https://api.maildeck.co/v1/domains/health" \
-H "Authorization: Bearer $MAILDECK_API_KEY"