Obtener un dominio

GET /api/v1/domains/{domainId} Un dominio con su estado de verificación y los registros DNS que publicar. Un domainId que pertenece a otra organización responde 404, nunca 403.

Autorización

Rol en la organización	Este endpoint
`OWNER`	Permitido
`ADMIN`	Permitido
`MEMBER`	Permitido

Una clave lleva el rol que su creador tiene en esta organización, nunca un rol en AgentsMail en sí. Consulta Claves de API.

Parámetros de ruta

Parámetro	Tipo	Descripción
`domainId`	string	Obligatorio. El dominio que se lee

Ejemplo

bash

curl -H "x-api-key: $AGENTMAIL_API_KEY" \
  "https://www.agentsmail.io/api/v1/domains/$DOMAIN_ID"

Respuesta

200 OK: la llamada tuvo éxito.
401 Unauthorized: clave ausente o no válida, o su propietario dejó la organización.
404 Not Found: no existe ese recurso, o pertenece a otra organización. La API nunca confirma que un id existe a quien no tiene derecho sobre él.
429 Too Many Requests: más de 120 peticiones en un minuto para esta clave.

Campos de la respuesta

Campo	Tipo	Descripción
`success`	boolean	Indica si la operación tuvo éxito
`data.id`	string	Identificador del dominio declarado
`data.domain`	string	El dominio en sí
`data.dkimStatus`	string	`PENDING`, `SUCCESS` o `FAILED`: las claves de firma
`data.mailFromStatus`	string \	null
`data.mailFromDomain`	string \	null
`data.verified`	boolean	La única pregunta que decide el envío: DKIM en `SUCCESS` y propiedad probada
`data.ownershipProved`	boolean	Cuál de los dos gestos falta todavía
`data.lastCheckedAt`	string \	null
`data.sesUnavailable`	boolean	`true` significa que estás leyendo el último estado conocido, no la verdad actual
`data.dnsRecords`	array	Los registros que publicar: `{type, name, value, purpose}`

Ejemplo de respuesta

json

{
  "success": true,
  "data": {
    "id": "4d19c0a2",
    "domain": "mail.example.com",
    "dkimStatus": "SUCCESS",
    "mailFromStatus": "SUCCESS",
    "mailFromDomain": "bounce.mail.example.com",
    "verified": true,
    "ownershipProved": true,
    "lastCheckedAt": "2026-08-23T10:22:05.000Z",
    "sesUnavailable": true,
    "dnsRecords": [
      {
        "type": "CNAME",
        "name": "abc123._domainkey.mail.example.com",
        "value": "abc123.dkim.amazonses.com",
        "purpose": "dkim"
      }
    ]
  }
}