---
title: "Get one message: metadata, parsed text body, headers, attachments, image refs."
method: GET
path: "/v1/messages/{id}"
tags: ["Messages"]
---

# Get one message: metadata, parsed text body, headers, attachments, image refs.

`GET /v1/messages/{id}`

## Request

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

## Path parameters

- `id` string, uuid, required

## Response `200`

Message.

- MessageDetail
  - `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.
  - `envelope_from` string, nullable
  - `text_body` string, nullable
  - `headers` object, nullable
  - `attachments` Attachment[]
    - `id` string, uuid, required
    - `filename` string, nullable
    - `content_type` string, nullable, required
    - `size_bytes` integer, required
  - `images` ImageRef[]
    - `kind` 'external' | 'inline', required
    - `proxy_url` string, uri, required: Short-lived l.inboxy.net/img/{token} URL. Original third-party URLs never leave the worker.
    - `alt` string, nullable
    - `width` string, nullable
    - `height` string, nullable
    - `attachment_id` string: Inline-only.

## Other responses

- `404`: No matching resource owned by the caller.

---

[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)