---
title: "Get an inbox"
method: GET
path: "/v1/inboxes/{id}"
tags: ["Inboxes"]
---

# Get an inbox

`GET /v1/inboxes/{id}`

## Request

- Base URL: `https://anjal.app`
- URL: `https://anjal.app/v1/inboxes/{id}`
- Auth: API key in header `X-API-Key`

Returns the inbox detail including IMAP/SMTP credentials and the full address list.

## Response `200`

OK

- Inbox
  - `id` string, uuid
  - `email` string: Current primary outbound address — may be a custom-domain alias.
  - `canonicalEmail` string: Stable identity used for IMAP/SMTP auth. Never changes after creation.
  - `username` string
  - `domain` string
  - `displayName` string
  - `workspaceId` string, uuid
  - `addresses` InboxAddress[]
    - `address` string
    - `isPrimary` boolean
  - `imapPassword` string: Only returned on creation and GET /inboxes/{id}. Stored plaintext so IMAP clients can log in.
  - `imap` ImapCreds
    - `host` string
    - `port` integer
    - `tls` boolean
    - `username` string
    - `password` string
  - `smtp` SmtpCreds
    - `host` string
    - `port` integer
    - `starttls` boolean
    - `username` string
    - `password` string
  - `createdAt` string, date-time

## Other responses

- `404`: Resource not found

---

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