Get Conversation

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 (the id field from List Conversations)

Response - Conversation fields

• id (string) - Unique conversation ID (UUID)
• display_id (integer) - Human-readable ticket number
• subject (string | null) - Conversation subject line
• status (string) - open, pending, on_hold, resolved, spam, or trash
• priority (string) - low, medium, high, or urgent
• source (string) - discord, email, portal, or webhook

• contact (object | null) - Customer who initiated the conversation

  • id (string) - Contact ID (UUID)
  • email (string) - Contact email address
  • name (string | null) - Contact display name
• inbox_email (string | null) - Email address of the receiving inbox
• first_response_at (string | null) - ISO 8601 timestamp of first agent response
• last_message_at (string | null) - ISO 8601 timestamp of most recent message
• created_at (string) - ISO 8601 timestamp
• updated_at (string) - ISO 8601 timestamp

Response - Messages array

• id (string) - Unique message ID (UUID)
• direction (string) - incoming or outgoing

• sender (object | null) - Who sent the message

  • email (string) - Sender email address
  • name (string | null) - Sender display name
• to (array | null) - To recipients (each with email and name)
• cc (array | null) - CC recipients (each with email and name)
• bcc (array | null) - BCC recipients (each with email and name)
• content (string | null) - Plain text message body
• content_html (string | null) - HTML message body
• is_private (boolean) - Whether this is an internal note
• created_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
  }
}