---
title: "List emails (unified inbox)"
method: GET
path: "/api/v1/emails"
tags: ["Emails"]
---

# List emails (unified inbox)

`GET /api/v1/emails`

## Request

- Base URL: `https://justemails.app`
- URL: `https://justemails.app/api/v1/emails`
- Auth: HTTP bearer

## Query parameters

- `folder` string
- `mailboxId` string, uuid
- `isRead` boolean
- `cursor` string
- `limit` integer

## Response `200`

OK

- object
  - `data` Email[], required
    - `id` string, uuid
    - `from` string
    - `to` string
    - `cc` string, nullable
    - `subject` string, nullable
    - `snippet` string, nullable
    - `folder` string
    - `isRead` boolean
    - `isStarred` boolean
    - `isDraft` boolean
    - `hasAttachments` boolean
    - `receivedAt` string, date-time
    - `mailboxId` string, uuid
  - `meta` object

---

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