Obtener estado del dominio

GET/v1/domains/{domain_name}/status

Para desarrolladores

Descripción

Devuelve si un dominio está verificado, a partir de su nombre. Si ya conoce el nombre y solo necesita saber eso, úselo en lugar de GET /v1/domains/{id}.

Guía relacionada

• Configurar su dominio de envío — Verifique MX, SPF, DKIM y DMARC en el DNS del dominio antes de enviar.

Autenticación

Authorizationbearer tokenheaderobligatorio

API key con scope domains:read. Formato: Bearer <API_KEY>.

X-Instance-Slugstringheaderobligatorio

Identificador de su instancia. Ver Autenticación.

Request

Path params:

domain_namestringobligatorio

Nombre del dominio, tal como quedó registrado (domain en `GET /v1/domains`).

Response

200 OKDevuelve un objeto con los campos que siguen.

idintegersiempre presente

Identificador del dominio.

domainstringsiempre presente

Nombre del dominio.

is_verifiedbooleansiempre presente

true únicamente cuando las cuatro verificaciones DNS (MX, SPF, DKIM, DMARC) están aprobadas.

Errores

Código	Cuándo
404	No existe un dominio con ese nombre en la instancia (domain_not_found).

Detalle en Errores genéricos.

Request

curl -X GET "https://$API_HOST/v1/domains/correos.micomercio.cl/status" \
-H "Authorization: Bearer $API_KEY" \
-H "X-Instance-Slug: $SLUG"

Response

{
"id": 7,
"domain": "correos.micomercio.cl",
"is_verified": true
}