API

Список переписки с контактом

Каждая цепочка, которую адрес написал или в которой ему писали, во всех папках: вкладка «Почта» у контакта в приложении. Адрес не обязан быть сохранённым контактом. `limit` до 100, по умолчанию 25, а `nextCursor` возвращается как `cursor`, пока `hasMore` равно true.

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

Выполняет настоящий запрос в вашем рабочем пространстве, с вашим собственным ключом.

GET /contacts/{email}/threads

Каждая цепочка, которую адрес написал или в которой ему писали, во всех папках: вкладка «Почта» у контакта в приложении. Адрес не обязан быть сохранённым контактом. limit до 100, по умолчанию 25, а nextCursor возвращается как cursor, пока hasMore равно true.

Пример

Требуется threads:read, потому что читается почта, а не контакт.

curl

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

Ответ

{  "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 ищет внутри этих цепочек с синтаксисом поиска ящика. sort бывает newest (по умолчанию), oldest, sender или subject. Возвращайте cursor с теми же q и sort.

Каждая строка это сводка. GET /threads/{id} читает письма за ней.