The inbox

GET

/admin/email/messages

Any admin. One holding email sees every address; any other sees the
addresses routed to them — their personal one, and any shared one
whose list they are on — whatever they ask for, and ?mine=true
keeps the email holder to their own as well. Newest first, without
bodies or headers. Narrow by address (its id), state, direction,
assignedTo or thread.

Request

Query Params

Responses

🟢200

application/json

The messages

Bodyapplication/json

🟠403AdminOnly

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.prod-orm.io/admin/email/messages?mine=&limit=&offset=&address=&state=&direction=&assignedTo=&thread='

Response Example

200 - Example 1

{
    "messages": [
        {
            "id": 0,
            "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
            "addressId": 0,
            "direction": "in",
            "state": "unread",
            "threadId": "51f72284-0555-48fe-a20a-4369ee94dc3e",
            "parentId": 0,
            "messageId": "string",
            "inReplyTo": "string",
            "from": {
                "address": "user@example.com",
                "name": "string"
            },
            "to": [
                {
                    "address": "user@example.com",
                    "name": "string"
                }
            ],
            "subject": "string",
            "preview": "string",
            "attachments": 0,
            "receivedAt": "2019-08-24T14:15:22.123Z",
            "assignedTo": 0,
            "sentBy": 0
        }
    ],
    "page": {
        "limit": 0,
        "offset": 0,
        "count": 0,
        "total": 0
    }
}

Modified at 2026-10-05 04:04:32

File a raw message, as if it had arrived

One message, whole