---
title: "List inbox messages"
method: GET
path: "/v1/email-users/{user_id}/inbox"
tags: ["Inbox"]
---

# List inbox messages

`GET /v1/email-users/{user_id}/inbox`

## Request

- Base URL: `https://api.winnr.app`
- URL: `https://api.winnr.app/v1/email-users/{user_id}/inbox`
- Auth: HTTP bearer

Get emails from the user's inbox. Results are scoped to this user's mailbox address only.

## Path parameters

- `user_id` string, required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

List of emails

- InboxListResponse
  - `data` Email[]
    - `id` string
    - `uid` string: IMAP UID
    - `message_id` string: RFC 2822 Message-ID header (use for In-Reply-To when replying)
    - `thread_id` string: Thread identifier for grouping related messages
    - `from` string: Raw from header (may include display name)
    - `from_name` string: Sender display name
    - `from_email` string: Sender email address
    - `to` string
    - `cc` string
    - `bcc` string
    - `reply_to` string
    - `subject` string
    - `body` string: Full email body text
    - `body_preview` string: First 200 characters of the body
    - `received_at` string, date-time
    - `has_attachments` boolean
    - `is_read` boolean
    - `mailbox` string: Email address of the mailbox that received this message
  - `pagination` Pagination: Pagination metadata. Cursor-based endpoints (e.g. `/v1/domains`, `/v1/email-users`, `/v1/inbox`, `/v1/email-users/{id}/inbox`) populate `has_more` and `cursor`. Offset-based endpoints (e.g. `/v1/warming`) populate `page`, `per_page`, and `total`. `count` (number of items in the current page) is included where available.
    - `has_more` boolean: Whether more pages exist after this one (cursor-based endpoints).
    - `cursor` string, nullable: Opaque cursor to pass as `?cursor=…` for the next page.
    - `count` integer: Number of items returned in this response.
    - `total` integer: Total number of items across all pages (offset-based endpoints).
    - `page` integer: 1-based page number (offset-based endpoints).
    - `per_page` integer: Items per page (offset-based endpoints).
  - `meta` Meta
    - `request_id` string
    - `timestamp` string, date-time

## Other responses

- `401`: Authentication required or token invalid
- `404`: Resource not found

---

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