# Read a sent message

GET /v1/sent/{message_id}

Source: https://cherami.to/docs/api/sending/get-sent-message



{/* Generated from apps/web/openapi. Edit the contract, not this file. */}

`GET /v1/sent/{message_id}`

Requires an [API key](https://cherami.to/docs/api#authentication): `Authorization: Bearer YOUR_CREDENTIAL`.

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.

## Parameters [#parameters]

| Parameter    | Location | Required | Type   | Meaning                                  |
| ------------ | -------- | -------- | ------ | ---------------------------------------- |
| `message_id` | path     | Yes      | string | Cherami resource ID returned by the API. |

## curl example [#curl-example]

Supply `CHERAMI_API_KEY` privately.

```sh
curl --silent --show-error --include --request GET \
  "https://cherami.to/v1/sent/MESSAGE_ID" \
  --header "Authorization: Bearer $CHERAMI_API_KEY"
```

## Responses [#responses]

### HTTP 200 [#http-200]

Success.

* `X-Request-ID`: Identifies this request; include it when reporting a problem.

Content type: `application/json`.

[SentDetail](#schema-sentdetail)

```json
{
  "id": "11111111-1111-4111-8111-111111111111",
  "inbox_id": "11111111-1111-4111-8111-111111111111",
  "created_at": "2026-10-01T00:00:00.000Z",
  "recipient_count": 0,
  "status": "unknown",
  "provider_message_id": null,
  "error_code": null,
  "thread_id": null,
  "in_reply_to": null,
  "labels": [],
  "reply_text": null,
  "submission": {
    "from": {
      "address": "my-agent@cherami.to"
    },
    "to": [],
    "cc": [],
    "bcc": [],
    "subject": "Example",
    "text": "Example",
    "attachments": []
  }
}
```

### HTTP 401 [#http-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).

* `X-Request-ID`: Identifies this request; include it when reporting a problem.
* `WWW-Authenticate`: `"Bearer"`

Content type: `application/json`.

[Error](#schema-error)

### HTTP 404 [#http-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.

* `X-Request-ID`: Identifies this request; include it when reporting a problem.

Content type: `application/json`.

[Error](#schema-error)

### HTTP 503 [#http-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.

* `X-Request-ID`: Identifies this request; include it when reporting a problem.

Content type: `application/json`.

[Error](#schema-error)

## Schema: SentDetail [#schema-sentdetail]

| Field                 | Required | Type                                        | Meaning and constraints                                                                                           |
| --------------------- | -------- | ------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| `id`                  | Yes      | string                                      | Cherami resource ID.                                                                                              |
| `inbox_id`            | Yes      | string                                      | Cherami resource ID.                                                                                              |
| `created_at`          | Yes      | string                                      | UTC timestamp with milliseconds. `format`: `date-time` `pattern`: `^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$` |
| `recipient_count`     | Yes      | integer                                     | `minimum`: `0`                                                                                                    |
| `status`              | Yes      | `"accepted"` or `"rejected"` or `"unknown"` |                                                                                                                   |
| `provider_message_id` | Yes      | string or null                              | Message-ID the provider assigned when it accepted the message.                                                    |
| `error_code`          | Yes      | string or null                              | Reason code for a rejected or unknown outcome, such as E\_RECIPIENT\_SUPPRESSED or acceptance\_unknown.           |
| `thread_id`           | Yes      | string or null                              |                                                                                                                   |
| `in_reply_to`         | Yes      | string or null                              |                                                                                                                   |
| `labels`              | Yes      | array of string                             |                                                                                                                   |
| `reply_text`          | Yes      | string or null                              | New text without quoted history. Empty: there is none. Null: it couldn't be extracted; read submission.           |
| `submission`          | Yes      | [Submission](#schema-submission)            |                                                                                                                   |

## Schema: Submission [#schema-submission]

What was sent, including the Sent via Cherami line.

| Field         | Required | Type                                                  | Meaning and constraints |
| ------------- | -------- | ----------------------------------------------------- | ----------------------- |
| `to`          | Yes      | array of [Mailbox](#schema-mailbox) or string         |                         |
| `cc`          | Yes      | array of [Mailbox](#schema-mailbox) or string         |                         |
| `bcc`         | Yes      | array of [Mailbox](#schema-mailbox) or string         |                         |
| `subject`     | Yes      | string                                                |                         |
| `text`        | Yes      | string                                                |                         |
| `html`        | No       | string                                                |                         |
| `attachments` | Yes      | array of [StoredAttachment](#schema-storedattachment) |                         |
| `from`        | Yes      | [Mailbox](#schema-mailbox) or string                  |                         |
| `headers`     | No       | object                                                |                         |

### `headers` fields [#headers-fields]

| Field         | Required | Type   | Meaning and constraints |
| ------------- | -------- | ------ | ----------------------- |
| `In-Reply-To` | Yes      | string |                         |
| `References`  | Yes      | string |                         |

## Schema: Mailbox [#schema-mailbox]

| Field     | Required | Type   | Meaning and constraints                                                                                                                 |
| --------- | -------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------- |
| `address` | Yes      | string | Bare address such as [alex@example.com](mailto:alex@example.com): ASCII, at most 254 characters and 64 before the @. `maxLength`: `254` |
| `name`    | No       | string | Optional name; blank means none. At most 256 UTF-8 bytes after trimming, without control characters. `x-max-utf8-bytes`: `256`          |

Unknown fields are rejected.

## Schema: StoredAttachment [#schema-storedattachment]

| Field         | Required | Type                         | Meaning and constraints                                                                                                 |
| ------------- | -------- | ---------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `filename`    | Yes      | string                       | At most 255 UTF-8 bytes, without control characters, slashes or backslashes. `minLength`: `1` `x-max-utf8-bytes`: `255` |
| `type`        | Yes      | string                       | MIME type without parameters. `maxLength`: `127` `pattern`: `^[A-Za-z0-9!#$&^_.+-]+/[A-Za-z0-9!#$&^_.+-]+$`             |
| `content`     | Yes      | string                       | The file's bytes as padded base64, without line breaks. `contentEncoding`: `base64` `pattern`: `^[A-Za-z0-9+/]*={0,2}$` |
| `disposition` | Yes      | `"attachment"` or `"inline"` |                                                                                                                         |
| `contentId`   | No       | string                       | Content-ID of an inline file carried over from a forwarded message.                                                     |

## Schema: Error [#schema-error]

| Field   | Required | Type   | Meaning and constraints |
| ------- | -------- | ------ | ----------------------- |
| `error` | Yes      | object |                         |

### `error` fields [#error-fields]

| Field     | Required | Type   | Meaning and constraints                                               |
| --------- | -------- | ------ | --------------------------------------------------------------------- |
| `code`    | Yes      | string | Code to handle. Handle a code you don't recognize by its HTTP status. |
| `message` | Yes      | string | Explanation of this case; its wording can change.                     |

[Errors, limits and pagination](https://cherami.to/docs/api/errors) · [Download OpenAPI 3.1](https://cherami.to/openapi.json)
