API

Listar las conversaciones con un contacto

Cada hilo que la dirección escribió o en el que se le escribió, en todas las carpetas: la pestaña Correo de un contacto en la app. La dirección no tiene que ser un contacto guardado. `limit` llega hasta 100 y vale 25 por defecto, y `nextCursor` vuelve como `cursor` mientras `hasMore` sea true.

GETapi.openemail.uk/contacts/{email}/threads

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

GET /contacts/{email}/threads

Cada hilo que la dirección escribió o en el que se le escribió, en todas las carpetas: la pestaña Correo de un contacto en la app. La dirección no tiene que ser un contacto guardado. limit llega hasta 100 y vale 25 por defecto, y nextCursor vuelve como cursor mientras hasMore sea true.

Ejemplo

Requiere threads:read, porque lee correo y no el contacto.

curl

curl "$OE/contacts/ada%40example.com/threads?q=invoice&sort=newest" -H "$AUTH"

Respuesta

{  "object": "list",  "data": [    {      "object": "thread",      "id": "thr_5d31c2a8…",      "subject": "Invoice 2026-09",      "from": { "name": "Ada Lovelace", "email": "[email protected]" },      "receivedAt": "2026-09-22T16:04:11.000Z",      "messageCount": 3,      "hasUnread": true,      "labels": [{ "id": "INBOX", "name": "Inbox" }]    }  ],  "hasMore": false,  "nextCursor": null}

q busca dentro de esos hilos con la sintaxis de búsqueda del buzón. sort es newest (por defecto), oldest, sender o subject. Devuelve cursor con los mismos q y sort.

Cada fila es un resumen. GET /threads/{id} lee los mensajes que hay detrás.