---
title: "List messages (newest first)"
method: GET
path: "/inboxes/{inbox}/messages"
tags: ["Messages"]
---

# List messages (newest first)

`GET /inboxes/{inbox}/messages`

## Request

- Base URL: `https://api.blinkinbox.club/api/v1`
- URL: `https://api.blinkinbox.club/api/v1/inboxes/{inbox}/messages`
- Auth: HTTP bearer

## Query parameters

- `since` string, date-time
- `from` string
- `subject` string
- `unread` boolean
- `limit` integer
- `page` integer

## Response `200`

OK

- object
  - `data` MessageSummary[]
    - `id` string
    - `from` string
    - `fromName` string
    - `subject` string
    - `preview` string
    - `receivedAt` string, date-time
    - `read` boolean
    - `otp` string, nullable: Best-guess one-time code, extracted on arrival.
    - `verificationLink` string, nullable: Best-guess verify / magic-link URL.
    - `attachments` integer
  - `total` integer
  - `page` integer
  - `limit` integer

## Other responses

- `401`: Missing or invalid API key
- `404`: Not found
- `429`: Rate limit or quota exceeded

---

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