Saltar al contenido principal

Obtener un dominio

GET/v1/domains/{id}

Para desarrolladores

Descripción​

Devuelve un dominio por su id, con el estado de cada verificación DNS y los registros que debe publicar. El alta y la baja de un dominio se hacen solo en el panel web.

La misma estructura la devuelven GET /v1/domains (cada elemento de data) y POST /v1/domains/{id}/validate.

Guía relacionada​

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:

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

Response​

200 OKDevuelve un objeto con los campos que siguen.
idintegersiempre presente
Identificador del dominio.
domainstringsiempre presente
Nombre de dominio normalizado.
mx_statusstring, enum: `pending | verified | failed | revoked`siempre presente
Estado de verificación del registro MX.
mx_verified_atstring (date-time) | nullsiempre presente
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`siempre presente
Estado de verificación del registro SPF.
spf_verified_atstring (date-time) | nullsiempre presente
Análogo a mx_verified_at, para SPF.
dkim_statusstring, enum: `pending | verified | failed | revoked`siempre presente
Estado de verificación de los registros DKIM.
dkim_verified_atstring (date-time) | nullsiempre presente
Análogo a mx_verified_at, para DKIM.
dmarc_statusstring, enum: `pending | verified | failed | revoked`siempre presente
Estado de verificación del registro DMARC.
dmarc_verified_atstring (date-time) | nullsiempre presente
Análogo a mx_verified_at, para DMARC.
ownership_tokenstringsiempre presente
Token único usado en dns_records.ownership_cname para probar la propiedad del dominio.
ownership_verified_atstring (date-time) | nullsiempre presente
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) | nullsiempre presente
Fecha de la última vez que se ejecutó la verificación DNS (exitosa o no). null si nunca se ejecutó.
created_atstring (date-time)siempre presente
—
updated_atstring (date-time)siempre presente
—
is_verifiedbooleansiempre presente
true únicamente cuando mx_status, spf_status, dkim_status y dmarc_status son verified simultáneamente.
is_ownership_verifiedbooleansiempre presente
true cuando ownership_verified_at tiene fecha. Es informativo: no condiciona la verificación ni el envío.
is_sandboxbooleansiempre presente
true en el dominio del entorno de pruebas provisionado con la cuenta. Siempre false en los dominios que registra usted. Ver El dominio del entorno de pruebas.
dns_recordsobjectsiempre presente
Los registros exactos a publicar, cada uno un objeto {type, host, value, priority}. Vienen completos en cada respuesta; no hace falta consultarlos aparte.
ownership_cnameobject
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.
mxobject
Enruta los rebotes hacia la plataforma. La verificación exige que este sea el único MX del dominio (ver por qué el MX debe ser exclusivo). Único registro con priority no nulo (10).
spfobject
Autoriza a la plataforma a enviar en nombre de este dominio. priority siempre null.
dkimarray, exactamente 2 elementos
Los dos CNAME de firma DKIM, uno por selector: s1 y s2 (el prefijo del host, como en s1._domainkey.…). Publique los dos: uno firma y el otro queda listo para rotar la clave sin interrumpir los envíos. Publíquelos como CNAME y no copie el TXT al que apuntan: ese TXT quedaría fijo con la clave actual y la verificación fallaría en la próxima rotación. priority siempre es null.
dmarcobject
Registro de política DMARC. Mínimo recomendado: p=none con un rua válido. priority siempre null.

Errores​

CódigoCuándo
404No 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
  }
}
}