---
title: "List messages, newest first."
method: GET
path: "/v1/messages"
tags: ["Messages"]
---

# List messages, newest first.

`GET /v1/messages`

## Request

- Base URL: `https://api.inboxy.net`
- URL: `https://api.inboxy.net/v1/messages`
- Auth: HTTP bearer

## Query parameters

- `address_id` string, uuid
- `classification` 'otp' | 'login_link' | 'verify' | 'receipt' | 'notice' | 'marketing' | 'spam' | 'other'
- `read` boolean
- `since` string, date-time
- `limit` integer
- `cursor` string

## Response `200`

Page of messages.

- MessagesPage
  - `messages` MessageMeta[], required
    - `id` string, uuid, required
    - `address_id` string, uuid
    - `from_email` string, email, required
    - `from_label` string, nullable
    - `subject` string, nullable
    - `received_at` integer, required: Unix seconds.
    - `classification` 'otp' | 'login_link' | 'verify' | 'receipt' | 'notice' | 'marketing' | 'spam' | 'other'
    - `urgency` 'low' | 'normal' | 'high' | 'null', nullable
    - `summary` string, nullable
    - `confidence` number, nullable
    - `read` boolean, required
    - `pending_classification` boolean
    - `forwarded_at` integer, nullable
    - `body_lost` boolean
    - `kept_at` integer, nullable: Unix seconds when the user pinned this message to bypass the retention sweep. Null = not kept.
  - `next_cursor` string, nullable: Pass to `?cursor=` for the next page.

---

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