Obtener un dominio

GET/v1/domains/{id}

Descripción

Retorna el detalle de un dominio por su id. Este es el detalle de campos que comparten también GET /v1/domains (cada elemento de data) y POST .../{id}/validate — el alta y la baja de un dominio son exclusivas del panel web.

Autenticación

Authorizationbearer tokenheaderobligatorio

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

X-Instance-Slugstringheaderobligatorio

Request

Path params:

idinteger

Identificador del dominio, devuelto por `GET /v1/domains`.

Response

200 OKDevuelve un objeto con los campos que siguen.

idintegerobligatorio

Identificador del dominio.

domainstringobligatorio

Nombre de dominio normalizado.

mx_statusstring, enum: `pending | verified | failed | revoked`obligatorio

Estado de verificación del registro MX.

mx_verified_atstring (date-time) | nullobligatorio

Fecha de la última validación de este registro, exitosa o no. null solo mientras no se haya ejecutado ninguna validación; después no vuelve a null.

spf_statusstring, enum: `pending | verified | failed | revoked`obligatorio

Estado de verificación del registro SPF.

spf_verified_atstring (date-time) | nullobligatorio

Análogo a mx_verified_at, para SPF.

dkim_statusstring, enum: `pending | verified | failed | revoked`obligatorio

Estado de verificación de los registros DKIM.

dkim_verified_atstring (date-time) | nullobligatorio

Análogo a mx_verified_at, para DKIM.

dmarc_statusstring, enum: `pending | verified | failed | revoked`obligatorio

Estado de verificación del registro DMARC.

dmarc_verified_atstring (date-time) | nullobligatorio

Análogo a mx_verified_at, para DMARC.

ownership_tokenstringobligatorio

Token único usado en dns_records.ownership_cname para probar la propiedad del dominio.

ownership_verified_atstring (date-time) | nullobligatorio

Se comporta distinto a los cuatro anteriores: se escribe una sola vez, cuando la propiedad se acredita, y permanece en null mientras no se haya acreditado.

last_verification_atstring (date-time) | nullobligatorio

Fecha de la última vez que se ejecutó la verificación DNS (exitosa o no). null si nunca se ejecutó.

created_atstring (date-time)obligatorio

—

updated_atstring (date-time)obligatorio

—

is_verifiedbooleanobligatorio

true únicamente cuando mx_status, spf_status, dkim_status y dmarc_status son verified simultáneamente.

is_ownership_verifiedbooleanobligatorio

Equivalente a ownership_verified_at is not null. Es informativo: no condiciona la verificación ni el envío.

is_sandboxbooleanobligatorio

true en el dominio del entorno de pruebas provisionado con la cuenta. Siempre false en un dominio registrado por el cliente. Ver El dominio del entorno de pruebas.

dns_recordsobjectobligatorio

Los registros exactos a publicar — ver tabla siguiente. Se calculan en cada respuesta a partir de los valores de infraestructura de la plataforma; el cliente no necesita consultarlos aparte.

dns_records (cada uno es un objeto {type, host, value, priority}):

ownership_cnameobjeto

Acredita la propiedad del dominio. Es informativo: no condiciona la verificación ni el envío, y se comprueba una sola vez. priority siempre null.

mxobjeto

Enruta los mensajes de bounce hacia la plataforma. La verificación exige que este sea el único MX del dominio (ver el gotcha del MX). Único registro con priority no nulo (10).

spfobjeto

Autoriza a la plataforma a enviar en nombre de este dominio. priority siempre null.

dkimarray, exactamente 2 elementos

Los dos CNAME de firma DKIM (selectores s1, s2). Ambos deben publicarse: uno firma y el otro queda disponible para rotar la llave sin interrumpir envíos. El CNAME es obligatorio — copiar el TXT al que apunta quedaría fijado a la llave vigente y dejaría de verificar en la próxima rotación. priority siempre null.

dmarcobjeto

Registro de política DMARC. Mínimo recomendado: p=none con un rua válido. priority siempre null.

Errores

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

Detalle en Errores genéricos.

Request

curl -X GET "https://$API_HOST/v1/domains/7" \
-H "Authorization: Bearer $API_KEY" \
-H "X-Instance-Slug: $SLUG"

Response

{
"id": 7,
"domain": "correos.micomercio.cl",
"mx_status": "pending",
"spf_status": "pending",
"dkim_status": "pending",
"dmarc_status": "pending",
"mx_verified_at": null,
"spf_verified_at": null,
"dkim_verified_at": null,
"dmarc_verified_at": null,
"ownership_token": "4ad93f2c49bd30afe3df3a88b401985e",
"ownership_verified_at": null,
"last_verification_at": null,
"is_verified": false,
"is_ownership_verified": false,
"is_sandbox": false,
"created_at": "2026-05-08T14:22:31Z",
"updated_at": "2026-05-08T14:22:31Z",
"dns_records": {
  "ownership_cname": {
    "type": "CNAME",
    "host": "_fidelizador-verify.correos.micomercio.cl",
    "value": "4ad93f2c49bd30afe3df3a88b401985e.fidelizador-verify.com",
    "priority": null
  },
  "mx": {
    "type": "MX",
    "host": "correos.micomercio.cl",
    "value": "<dominio MX de bounce de la plataforma>",
    "priority": 10
  },
  "spf": {
    "type": "TXT",
    "host": "correos.micomercio.cl",
    "value": "v=spf1 include:<dominio SPF de la plataforma> -all",
    "priority": null
  },
  "dkim": [
    {
      "type": "CNAME",
      "host": "s1._domainkey.correos.micomercio.cl",
      "value": "s1._domainkey.<dominio de publicación de la plataforma>",
      "priority": null
    },
    {
      "type": "CNAME",
      "host": "s2._domainkey.correos.micomercio.cl",
      "value": "s2._domainkey.<dominio de publicación de la plataforma>",
      "priority": null
    }
  ],
  "dmarc": {
    "type": "TXT",
    "host": "_dmarc.correos.micomercio.cl",
    "value": "v=DMARC1;p=none;rua=<dirección de reporte DMARC>",
    "priority": null
  }
}
}