Read a sent message
GET /v1/sent/{message_id}
Read as Markdown ↗GET /v1/sent/{message_id}
Requires an API key: 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
| Parameter | Location | Required | Type | Meaning |
|---|---|---|---|---|
message_id | path | Yes | string | Cherami resource ID returned by the API. |
curl example
Supply CHERAMI_API_KEY privately.
curl --silent --show-error --include --request GET \
"https://cherami.to/v1/sent/MESSAGE_ID" \
--header "Authorization: Bearer $CHERAMI_API_KEY"Responses
HTTP 200
Success.
X-Request-ID: Identifies this request; include it when reporting a problem.
Content type: application/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
unauthorized: Send a valid API key as Authorization: Bearer <key>. If the key stopped working, get a new one through recovery.
X-Request-ID: Identifies this request; include it when reporting a problem.WWW-Authenticate:"Bearer"
Content type: application/json.
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.
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.
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
What was sent, including the Sent via Cherami line.
| Field | Required | Type | Meaning and constraints |
|---|---|---|---|
to | Yes | array of Mailbox or string | |
cc | Yes | array of Mailbox or string | |
bcc | Yes | array of Mailbox or string | |
subject | Yes | string | |
text | Yes | string | |
html | No | string | |
attachments | Yes | array of StoredAttachment | |
from | Yes | Mailbox or string | |
headers | No | object |
headers fields
| Field | Required | Type | Meaning and constraints |
|---|---|---|---|
In-Reply-To | Yes | string | |
References | Yes | string |
Schema: Mailbox
| Field | Required | Type | Meaning and constraints |
|---|---|---|---|
address | Yes | string | Bare address such as 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
| 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
| Field | Required | Type | Meaning and constraints |
|---|---|---|---|
error | Yes | object |
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. |