API

Retrieve a label

One label by id, in the same shape as a row of the list.

GETapi.openemail.uk/labels/{id}

Runs the real call against your workspace, with your own key.

GET /labels/{id}

One label by id, in the same shape as a row of the list.

Example

Needs labels:read.

curl

curl "$OE/labels/USER_INVOICES" -H "$AUTH"

Response

{  "object": "label",  "id": "USER_INVOICES",  "name": "Invoices",  "type": "user",  "color": { "backgroundColor": "#EA9602", "textColor": "#18181B" },  "threadCount": 318,  "createdAt": "2026-09-22T08:14:03.117Z",  "updatedAt": "2026-09-23T10:02:44.508Z"}

Ids are matched exactly, and a system id such as INBOX is a 404.