Get a message

GEThttps://myagentmail.com/v1/inboxes/{id}/messages/{messageId}

Returns full bodies plus attachment metadata. Also marks the message as read.

Path parameters

`id` required string	Inbox UUID
`messageId` required string	Message UUID

Responses

200application/jsonOK

`id` string	format: uuid
`direction` "inbound" \| "outbound"	enum: "inbound" \| "outbound"
`from` string
`to` string
`subject` string
`plainBody` string
`htmlBody` string
`isRead` boolean
`threadId` string	format: uuid
`messageIdHeader` string
`inReplyTo` string
`receivedAt` string	format: date-time
`attachments` object[]
`id` string	format: uuid
`filename` string
`contentType` string
`sizeBytes` integer

Authentication

Send your API key in the X-API-Key header (or Authorization: Bearer <key>). Any prefix accepted by this endpoint — tk_, wk_, ak_, or sa_ — is documented in the key prefix table.

Request

import { MyAgentMail } from "myagentmail";

const client = new MyAgentMail({ apiKey: process.env.MYAGENTMAIL_API_KEY! });

// GET /v1/inboxes/{id}/messages/{messageId}
const result = await client.request("get", "/v1/inboxes/{id}/messages/{messageId}", { params: { id: "00000000-0000-0000-0000-000000000000", messageId: "00000000-0000-0000-0000-000000000000" } });

Example response · 200

{
  "id": "00000000-0000-0000-0000-000000000000",
  "direction": "inbound",
  "from": "string",
  "to": "string",
  "subject": "string",
  "plainBody": "string",
  "htmlBody": "string",
  "isRead": false,
  "threadId": "00000000-0000-0000-0000-000000000000",
  "messageIdHeader": "string",
  "inReplyTo": "string",
  "receivedAt": "2026-05-01T08:11:44.754Z",
  "attachments": [
    {
      "id": "00000000-0000-0000-0000-000000000000",
      "filename": "string",
      "contentType": "application/pdf",
      "sizeBytes": 0
    }
  ]
}