---
title: "Read a sent message"
method: GET
path: "/v1/sent/{message_id}"
tags: ["sending"]
---

# Read a sent message

`GET /v1/sent/{message_id}`

## Request

- Base URL: `https://cherami.to`
- URL: `https://cherami.to/v1/sent/{message_id}`
- Auth: HTTP bearer

Returns a sent message's outcome (`status`, `error_code`) and, in `submission`, what was sent, attachments included as base64. Names are as they were at sending, not the inbox's current settings.

## Path parameters

- `message_id` string, required

## Response `200`

Success.

- SentDetail
  - `id` string, required: Cherami resource ID.
  - `inbox_id` string, required: Cherami resource ID.
  - `created_at` string, date-time, required: UTC timestamp with milliseconds.
  - `recipient_count` integer, required
  - `status` 'accepted' | 'rejected' | 'unknown', required
  - `provider_message_id` string, nullable, required: Message-ID the provider assigned when it accepted the message.
  - `error_code` string, nullable, required: Reason code for a rejected or unknown outcome, such as E_RECIPIENT_SUPPRESSED or acceptance_unknown.
  - `thread_id` string, nullable, required: Cherami resource ID.
  - `in_reply_to` string, nullable, required: Cherami resource ID.
  - `labels` string[], required
  - `reply_text` string, nullable, required: New text without quoted history. Empty: there is none. Null: it couldn't be extracted; read submission.
  - `submission` Submission, required: What was sent, including the Sent via Cherami line.
    - `to` union[], required
      - union
        - Mailbox
          - `address` string, required: Bare address such as alex@example.com: ASCII, at most 254 characters and 64 before the @.
          - `name` string: Optional name; blank means none. At most 256 UTF-8 bytes after trimming, without control characters.
        - string: Plain address string, as some older messages store it.
    - `cc` union[], required
      - union
        - Mailbox
          - `address` string, required: Bare address such as alex@example.com: ASCII, at most 254 characters and 64 before the @.
          - `name` string: Optional name; blank means none. At most 256 UTF-8 bytes after trimming, without control characters.
        - string: Plain address string, as some older messages store it.
    - `bcc` union[], required
      - union
        - Mailbox
          - `address` string, required: Bare address such as alex@example.com: ASCII, at most 254 characters and 64 before the @.
          - `name` string: Optional name; blank means none. At most 256 UTF-8 bytes after trimming, without control characters.
        - string: Plain address string, as some older messages store it.
    - `subject` string, required
    - `text` string, required
    - `html` string
    - `attachments` StoredAttachment[], required
      - `filename` string, required: At most 255 UTF-8 bytes, without control characters, slashes or backslashes.
      - `type` string, required: MIME type without parameters.
      - `content` string, byte, required: The file's bytes as padded base64, without line breaks.
      - `disposition` 'attachment' | 'inline', required
      - `contentId` string: Content-ID of an inline file carried over from a forwarded message.
    - `from` union, required
      - Mailbox
        - `address` string, required: Bare address such as alex@example.com: ASCII, at most 254 characters and 64 before the @.
        - `name` string: Optional name; blank means none. At most 256 UTF-8 bytes after trimming, without control characters.
      - string: Plain address string, as some older messages store it.
    - `headers` object
      - `In-Reply-To` string, required
      - `References` string, required

## Other responses

- `401`: `unauthorized`: Send a valid API key as `Authorization: Bearer <key>`. If the key stopped working, get a new one through [recovery](https://cherami.to/docs/guides/recovery).
- `404`: `not_found`: The resource does not exist or does not belong to this account. A reply or forward source must also be in the sending inbox.
- `503`: `content_unavailable`: Stored content could not be read. Retry later. `outbound_unavailable`: The request failed. If it was a send, reply or forward, its outcome is unknown: repeat it with the same idempotency key and unchanged payload within 24 hours of the first request; without a key, check sent messages before sending again. Retry a read.

---

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