---
title: "List inbox messages"
method: GET
path: "/v1/inbox/{address}"
tags: ["inbox"]
---

# List inbox messages

`GET /v1/inbox/{address}`

## Request

- Base URL: `https://agentlair.dev`
- URL: `https://agentlair.dev/v1/inbox/{address}`
- Auth: HTTP bearer

List messages for the inbox. Auto-claims the address on first access.

## Path parameters

- `address` string, required

## Query parameters

- `limit` integer
- `unread` boolean

## Response `200`

Messages list

- object
  - `messages` object[]
    - `id` string
    - `from` string
    - `subject` string
    - `preview` string
    - `received_at` string, date-time
    - `read` boolean
  - `total` integer
  - `address` string

---

[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)