# List inboxes

**`GET https://myagentmail.com/v1/inboxes`**

Group: Inboxes
Operation ID: `listInboxes`

## Query parameters

- `workspace` (string) — Tenant master only — filter to a single workspace.

## Responses

### 200 — OK

```json
{
  "inboxes": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "email": "scout-abc123@delegated.cc",
      "canonicalEmail": "scout-abc123-10deac42@myagentmail.com",
      "username": "string",
      "domain": "string",
      "displayName": "string",
      "workspaceId": "00000000-0000-0000-0000-000000000000",
      "addresses": [
        {}
      ],
      "imapPassword": "string",
      "imap": {
        "host": "imap.myagentmail.com",
        "port": 993,
        "tls": false,
        "username": "string",
        "password": "string"
      },
      "smtp": {
        "host": "smtp.myagentmail.com",
        "port": 587,
        "starttls": false,
        "username": "string",
        "password": "string"
      },
      "createdAt": "2026-05-01T08:11:44.626Z"
    }
  ]
}
```

## Code samples

### TypeScript

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

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

// GET /v1/inboxes
const result = await client.request("get", "/v1/inboxes");
```

### curl

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

### Python

```python
import os, requests

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