API

Recuperar un dominio

Añade las direcciones que existen en él y si cada una está habilitada.

GETapi.openemail.uk/domains/{id}

Ejecuta la llamada real contra tu espacio de trabajo, con tu propia clave.

GET /domains/{id}

Añade las direcciones que existen en él y si cada una está habilitada.

Ejemplo

Requiere domains:read.

curl

curl "$OE/domains/b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f" -H "$AUTH"

Respuesta

{  "object": "domain",  "id": "b3e1f0a4-6c2d-4e8a-9f17-2d5c8a0b4e6f",  "domain": "acme.com",  "receiving": {    "verified": true,    "verifiedAt": "2026-08-14T10:02:00.000Z",    "catchAll": false,    "lastCheckedAt": "2026-08-29T06:00:00.000Z",    "error": null  },  "sending": {    "status": "verified",    "canSend": true,    "checkedAt": "2026-08-29T06:00:00.000Z",    "error": null,    "note": "Mail from this domain is signed and can be sent."  },  "tracking": {    "host": "links.acme.com",    "status": "active",    "active": true,    "target": "oelinks3f9a1c7e2b8d4a60.edge.openemail.uk",    "record": { "type": "CNAME", "name": "links.acme.com", "value": "oelinks3f9a1c7e2b8d4a60.edge.openemail.uk" },    "checkedAt": "2026-08-29T06:10:00.000Z",    "verifiedAt": "2026-08-29T06:10:00.000Z",    "error": null  },  "storage": {    "host": "files.acme.com",    "status": "active",    "active": true,    "target": "oefiles81c40d6b2f7e9a35.edge.openemail.uk",    "record": { "type": "CNAME", "name": "files.acme.com", "value": "oefiles81c40d6b2f7e9a35.edge.openemail.uk" },    "checkedAt": "2026-08-29T06:10:00.000Z",    "verifiedAt": "2026-08-29T06:10:00.000Z",    "error": null  },  "addresses": [    { "address": "[email protected]", "enabled": true },    { "address": "[email protected]", "enabled": false }  ],  "createdAt": "2026-08-14T09:55:11.000Z"}

Una dirección deshabilitada deja de ser entregable. El correo dirigido a ella se rechaza en el momento SMTP, así que el remitente recibe un rebote en lugar de silencio.

Lo que aquí todavía no puedes hacer

Aún no disponible

Las escrituras que admite este recurso son el dominio de seguimiento personalizado y el dominio de archivos personalizado, ambas mediante PATCH /domains/{id}. El resto de la configuración de un dominio está por ahora solo en la aplicación.

Añadir un dominio y leer los registros DNS que hay que publicar. GET informa de que un dominio no está verificado, pero no de qué registro falta.
Disparar una nueva comprobación de receiving o sending. Ninguna tiene endpoint, y ninguna lo necesita: un barrido cada hora vuelve a comprobar por su cuenta todos los dominios sin verificar, así que publicar los registros y dejarlos es todo el trabajo. Suscríbete a domain.verified y domain.sending_changed en lugar de consultar GET /domains en bucle, y se te avisará en cuanto cualquiera de los dos se mueva. PATCH /domains/{id} solo comprueba el dominio de seguimiento y el dominio de archivos.
Crear, deshabilitar o enrutar una dirección. COMPARTIR una sí está hecho, ya que POST /members/{userId}/addresses entrega una dirección existente a alguien con nivel member o viewer. Lo que este recurso no puede hacer es que la dirección llegue a existir.

Todo ello existe en la aplicación, en Configuración → Dominios. Lo que falta es la superficie de la API, no la capacidad.