Obtener estado del dominio

GET/v1/domains/{domain_name}/status

Descripción

Retorna el estado de verificación de un dominio identificado por su nombre — una consulta liviana frente a GET /v1/domains/{id} cuando el cliente ya conoce el nombre y solo necesita saber si está verificado.

Autenticación

Authorizationbearer tokenheaderobligatorio

API key con scope domains:read. Formato: Bearer FD.<key_id>.<token>.

X-Instance-Slugstringheaderobligatorio

Request

Path params:

domain_namestring

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

Response

200 OKDevuelve un objeto con los campos que siguen.

idintegerobligatorio

Identificador del dominio.

domainstringobligatorio

Nombre del dominio.

is_verifiedbooleanobligatorio

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
}