# List messages

**`GET https://myagentmail.com/v1/inboxes/{id}/messages`**

Group: Messages
Operation ID: `listMessages`

## Path parameters

- `id` (string, required) — Inbox UUID

## Query parameters

- `limit` (integer) —
- `offset` (integer) —
- `direction` ("inbound" | "outbound") —

## Responses

### 200 — OK

```json
{
  "messages": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "direction": "inbound",
      "from": "string",
      "to": "string",
      "subject": "string",
      "plainBody": "string",
      "htmlBody": "string",
      "isRead": false,
      "threadId": "00000000-0000-0000-0000-000000000000",
      "messageIdHeader": "string",
      "inReplyTo": "string",
      "receivedAt": "2026-05-01T08:11:44.578Z",
      "attachments": [
        {}
      ]
    }
  ],
  "pagination": {
    "total": 0,
    "limit": 0,
    "offset": 0
  }
}
```

## Code samples

### TypeScript

```typescript
import { MyAgentMail } from "myagentmail";

const client = new MyAgentMail({ apiKey: process.env.MYAGENTMAIL_API_KEY! });

// GET /v1/inboxes/{id}/messages
const result = await client.request("get", "/v1/inboxes/{id}/messages", { params: { id: "00000000-0000-0000-0000-000000000000" } });
```

### curl

```bash
curl -X GET 'https://myagentmail.com/v1/inboxes/00000000-0000-0000-0000-000000000000/messages' \
  -H 'X-API-Key: $MYAGENTMAIL_API_KEY'
```

### Python

```python
import os, requests

r = requests.get(
    "https://myagentmail.com/v1/inboxes/00000000-0000-0000-0000-000000000000/messages",
    headers={"X-API-Key": os.environ["MYAGENTMAIL_API_KEY"]},
)
r.raise_for_status()
print(r.json())
```