curl https://api.gork.email/v1/messages/msg_90e38dfb4a2c \
-H "Authorization: Bearer gork_live_YOUR_API_KEY"
import { Gork } from "@gork/sdk"
const gork = new Gork({ apiKey: process.env.GORK_API_KEY })
const message = await gork.messages.get("msg_90e38dfb4a2c")
import requests, os
res = requests.get(
"https://api.gork.email/v1/messages/msg_90e38dfb4a2c",
headers={"Authorization": f"Bearer {os.getenv('GORK_API_KEY')}"},
)
{
"data": {
"id": "msg_90e38dfb4a2c",
"inboxId": "inb_728af980b4e",
"threadId": "thd_128bca90f4",
"direction": "inbound",
"fromAddress": "billing@acme.com",
"toAddresses": ["support@try.gork.email"],
"subject": "Invoice 1042",
"textBody": "Invoice attached.",
"htmlBody": null,
"status": "received",
"attachments": [
{
"id": "att_1a2b3c4d5e6f",
"filename": "invoice-1042.pdf",
"contentType": "application/pdf",
"sizeBytes": 48210
}
],
"createdAt": "2026-09-11T08:00:00.000Z"
}
}
Messages
Get Message
Fetch a single message with attachment metadata and hydrated HTML body.
GET
/
v1
/
messages
/
{id}
curl https://api.gork.email/v1/messages/msg_90e38dfb4a2c \
-H "Authorization: Bearer gork_live_YOUR_API_KEY"
import { Gork } from "@gork/sdk"
const gork = new Gork({ apiKey: process.env.GORK_API_KEY })
const message = await gork.messages.get("msg_90e38dfb4a2c")
import requests, os
res = requests.get(
"https://api.gork.email/v1/messages/msg_90e38dfb4a2c",
headers={"Authorization": f"Bearer {os.getenv('GORK_API_KEY')}"},
)
{
"data": {
"id": "msg_90e38dfb4a2c",
"inboxId": "inb_728af980b4e",
"threadId": "thd_128bca90f4",
"direction": "inbound",
"fromAddress": "billing@acme.com",
"toAddresses": ["support@try.gork.email"],
"subject": "Invoice 1042",
"textBody": "Invoice attached.",
"htmlBody": null,
"status": "received",
"attachments": [
{
"id": "att_1a2b3c4d5e6f",
"filename": "invoice-1042.pdf",
"contentType": "application/pdf",
"sizeBytes": 48210
}
],
"createdAt": "2026-09-11T08:00:00.000Z"
}
}
Returns one message in your organization, including its attachment metadata. The HTML body is hydrated from object storage when it is not stored inline, so
htmlBody is always populated when the message has HTML.
Headers
string
required
Bearer token formatted as
Bearer gork_live_.... Requires the messages:read scope.Path parameters
string
required
The message ID (
msg_...).Inbox-bound agent keys may only fetch messages in their own inbox — anything else returns
403 inbox_access_denied.Response
object
Show properties
Show properties
string
Unique message ID (
msg_...).string
The inbox this message belongs to.
string
The conversation thread (
thd_...).string
inbound for received mail, outbound for sent mail.string
Sender email address.
string[]
Recipient addresses.
string
Subject line.
string
Plain-text body, or
null when absent.string
HTML body (hydrated from storage when needed), or
null when absent.string
Delivery status (e.g.
received, delivered, scheduled, failed, cancelled).object[]
Attachment metadata rows for this message (
id, filename, contentType, sizeBytes). Use GET /v1/attachments/{id} to download bytes.string
ISO 8601 creation timestamp.
curl https://api.gork.email/v1/messages/msg_90e38dfb4a2c \
-H "Authorization: Bearer gork_live_YOUR_API_KEY"
import { Gork } from "@gork/sdk"
const gork = new Gork({ apiKey: process.env.GORK_API_KEY })
const message = await gork.messages.get("msg_90e38dfb4a2c")
import requests, os
res = requests.get(
"https://api.gork.email/v1/messages/msg_90e38dfb4a2c",
headers={"Authorization": f"Bearer {os.getenv('GORK_API_KEY')}"},
)
{
"data": {
"id": "msg_90e38dfb4a2c",
"inboxId": "inb_728af980b4e",
"threadId": "thd_128bca90f4",
"direction": "inbound",
"fromAddress": "billing@acme.com",
"toAddresses": ["support@try.gork.email"],
"subject": "Invoice 1042",
"textBody": "Invoice attached.",
"htmlBody": null,
"status": "received",
"attachments": [
{
"id": "att_1a2b3c4d5e6f",
"filename": "invoice-1042.pdf",
"contentType": "application/pdf",
"sizeBytes": 48210
}
],
"createdAt": "2026-09-11T08:00:00.000Z"
}
}
| Code | HTTP | Meaning |
|---|---|---|
inbox_access_denied | 403 | The key is bound to a different inbox than this message. |
message_not_found | 404 | No message with this ID exists in your organization. |