---
title: "Read inbox"
method: GET
path: "/v1/email/inbox"
tags: ["email"]
---

# Read inbox

`GET /v1/email/inbox`

## Request

- Base URL: `https://agentlair.dev`
- URL: `https://agentlair.dev/v1/email/inbox`
- Auth: HTTP bearer

List messages for an `@agentlair.dev` address.
**Auto-claims the address on first access** (respects per-tier limits).
Returns message snippets (first 120 chars). Use `GET /v1/email/messages/{id}` for full body.

## Query parameters

- `address` string, required
- `limit` integer

## Response `200`

Messages list

- object
  - `messages` EmailMessage[]
    - `message_id` string
    - `from` string
    - `to` string
    - `subject` string
    - `snippet` string: First 120 characters of message body (list view)
    - `received_at` string, date-time
    - `read` boolean
    - `archived` boolean: Whether the message has been archived (default false)
    - `e2e_encrypted` boolean: Present and true when address has E2E key registered
  - `has_more` boolean
  - `count` integer
  - `address` string

## Other responses

- `403`: Address belongs to another account

---

[API](https://skmtc.dev/agentlair/apis/agentlair-api.md) · [All operations](https://skmtc.dev/agentlair/apis/agentlair-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentlair/apis/agentlair-api/revisions/fac95ff4995d?raw)