---
title: "Get DNS status"
method: GET
path: "/2/mail_hostings/{service_mail}/dns-status"
tags: ["Others/Others"]
---

# Get DNS status

`GET /2/mail_hostings/{service_mail}/dns-status`

## Request

- Base URL: `https://api.infomaniak.com`
- URL: `https://api.infomaniak.com/2/mail_hostings/{service_mail}/dns-status`
- Auth: HTTP bearer

Get the DNS status of a service mail.

Returns information about the DNS state of the service mail domain, such as
whether the domain is still propagating after a recent creation or whether
the MX records are missing or invalid.

## Path parameters

- `service_mail` string, required

## Response `200`

OK

- object
  - `result` 'success' | 'error' | 'asynchronous', required: Result of the HTTP request
  - `data` 93e74a89DNSstatus
    - `state` 'dkim_error' | 'dns_errors' | 'healthy' | 'just_created_and_configured' | 'mx_error' | 'spf_error', required: The DNS state of the service mail domain.<note><strong>dkim_error</strong>: The DKIM record is missing or does not match the stored key, emails may not be signed correctly.</note><note><strong>dns_errors</strong>: Multiple DNS records are missing or incorrect, the mail service may not work properly.</note><note><strong>healthy</strong>: The domain DNS is healthy and MX/SPF/DKIM records are correctly configured.</note><note><strong>just_created_and_configured</strong>: The domain is still propagating after a recent creation.</note><note><strong>mx_error</strong>: The MX records are missing or incorrect, email reception may not work.</note><note><strong>spf_error</strong>: The SPF record is missing or incorrect, emails may be rejected or marked as spam.</note>

## Changes

- **2026-10-28** `876c540ed2ae`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/changes/2/mail_hostings/:service_mail/dns-status/get.md)

---

[API](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools.md) - [All operations](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/llms.txt) - [OpenAPI document](https://skmtc.dev/infomaniak/apis/api-reference-developer-tools/revisions/96ca7c8a0545?raw)