---
title: "mail.messages.read · OpenVibe.Services"
canonical: "https://openvibe.services/docs/capabilities/mail.messages.read"
updated: null
---

# mail.messages.read · OpenVibe.Services

HTML: [mail.messages.read · OpenVibe.Services](https://openvibe.services/docs/capabilities/mail.messages.read)

# `mail.messages.read`

Generated at 2026-11-13 06:25:48 UTC from [`openvibe-contracts v0.419.0`](https://github.com/OpenVibers/OpenVibe.Contracts/tree/v0.419.0) and [`openvibe-sdk v0.161.0`](https://github.com/OpenVibers/OpenVibe.SDK/tree/v0.161.0).

Not grantable to apps (active, first-party).

Read what arrived for a person's addresses: the addresses they own with their state and counts, and the metadata of a mask's, burner's or agent inbox's messages (sender, subject, time) plus the newest verification code in a burner. Never a message body, and never another person's mail. The caller must act for the person (on\_behalf\_of), except a burner read with the one-time token its create call returned.

- Owner: mail (token audience `openvibe.mail`)
- Version: 1.0
- Status: active
- Visibility: first-party
- Resource constraints: owner
- Quota class: mail-messages-read
- Permissions: mail:messages:read
- Events: mail.received
- Implemented by: - `GET /api/v1/me/mail`
- `GET /api/v1/masks`
- `GET /api/v1/masks/:id`
- `GET /api/v1/burners`
- `GET /api/v1/burners/:id/messages`
- `GET /api/v1/burners/:id/code`
- `GET /api/v1/agent-inboxes`
- `GET /api/v1/agent-inboxes/:id/messages`

[These routes in the API explorer](/docs/api/mail#cap-mail.messages.read)