API

Listar dominios

Todos los dominios del espacio de trabajo, con su estado de recepción, envío, seguimiento y archivos.

GETapi.openemail.uk/domains

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

GET /domains

Todos los dominios del espacio de trabajo, con su estado de recepción, envío, seguimiento y archivos.

Recibir y enviar son cosas distintas

Todos los dominios informan de la recepción y del envío como dos objetos de estado independientes. receiving.verified significa que el MX del dominio trae su correo aquí y que su desafío de propiedad está publicado, así que el dominio puede aceptar entregas. No dice nada sobre la salida.

sending es la mitad saliente, leída de la comprobación de firma almacenada del dominio y no de una nueva. sending.status es uno de verified, pending, failed, no_identity o unknown, sending.canSend dice si un envío desde el dominio se aceptaría ahora mismo, sending.checkedAt fecha ese veredicto, sending.error lleva el último fallo y sending.note es una frase que explica el estado. Un veredicto negativo de hace más de un día se trata como desconocido y no como un rechazo, así que canSend puede ser true mientras status es pending.

tracking es un tercer objeto, sobre el dominio de seguimiento personalizado opcional del dominio y no sobre su correo. tracking.status es none hasta que se configura uno, en la aplicación o con PATCH /domains/{id}, cuya página describe todos los campos.

storage es un cuarto objeto con los mismos campos, sobre el dominio de archivos personalizado opcional del dominio: el nombre que usan los enlaces de descarga de los archivos enviados desde el dominio. Se configura igual y en la misma página, y storage.status es none hasta que se configura uno.

Ejemplo

Requiere domains:read.

curl

curl "$OE/domains" -H "$AUTH"

Respuesta

{  "object": "list",  "data": [    {      "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      },      "createdAt": "2026-08-14T09:55:11.000Z"    }  ]}

lastCheckedAt en null significa que el DNS nunca se ha mirado: «todavía no lo hemos mirado», no «falló». Las dos cosas se leen de manera muy distinta treinta segundos después de añadir un dominio.