API Documentation
GET /api/v1/conversations/{id}
Retrieve a single conversation with all its messages, including sender and recipient details.
Path parameters
id(string) - Conversation UUID (theidfield from List Conversations)
Response - Conversation fields
id(string) - Unique conversation ID (UUID)display_id(integer) - Human-readable ticket numbersubject(string | null) - Conversation subject linestatus(string) - open, pending, on_hold, resolved, spam, or trashpriority(string) - low, medium, high, or urgentsource(string) - discord, email, portal, or webhookcontact(object | null) - Customer who initiated the conversationid(string) - Contact ID (UUID)email(string) - Contact email addressname(string | null) - Contact display name
inbox_email(string | null) - Email address of the receiving inboxfirst_response_at(string | null) - ISO 8601 timestamp of first agent responselast_message_at(string | null) - ISO 8601 timestamp of most recent messagecreated_at(string) - ISO 8601 timestampupdated_at(string) - ISO 8601 timestamp
Response - Messages array
id(string) - Unique message ID (UUID)direction(string) - incoming or outgoingsender(object | null) - Who sent the messageemail(string) - Sender email addressname(string | null) - Sender display name
to(array | null) - To recipients (each withemailandname)cc(array | null) - CC recipients (each withemailandname)bcc(array | null) - BCC recipients (each withemailandname)content(string | null) - Plain text message bodycontent_html(string | null) - HTML message bodyis_private(boolean) - Whether this is an internal notecreated_at(string) - ISO 8601 timestamp
Example Request
curl "https://api.letterbook.ai/api/v1/conversations/YOUR_CONVERSATION_ID" \
-H "Authorization: Bearer hld_your_key_here"Example Response
{
"data": [
{
"id": "a1b2c3d4-5678-90ab-cdef-1234567890ab",
"display_id": 42,
"subject": "Help with order #1234",
"status": "open",
"priority": "high",
"source": "email",
"contact": {
"id": "f9e8d7c6-5432-10ba-fedc-ba0987654321",
"email": "[email protected]",
"name": "John Doe"
},
"inbox_email": "[email protected]",
"first_response_at": "2026-04-09T14:30:00+00:00",
"last_message_at": "2026-04-09T15:45:00+00:00",
"created_at": "2026-04-09T14:00:00+00:00",
"updated_at": "2026-04-09T15:45:00+00:00"
}
],
"pagination": {
"page": 1,
"page_size": 20,
"has_next_page": false,
"has_previous_page": false
}
}