Get Conversation

GET /v1/inbox/conversations/{conversationId}

Retrieve a specific conversation with its messages.

Path parameters

conversationIdstringrequired

Conversation ID

Response

200Successfully retrieved conversation with messages.

objectstringrequired

idstringrequired

Unique conversation identifier

subjectstringrequired

Conversation subject line

statusstringrequired

Conversation status (OPEN, CLOSED, ARCHIVED)

originTypestringrequired

Origin type of the conversation

originIdstringrequired

Origin identifier

messageCountnumberrequired

Total number of messages

unreadCountnumberrequired

Number of unread messages

lastMessageAtstringrequired

ISO 8601 timestamp of the last message

createdAtstringrequired

ISO 8601 timestamp when the conversation was created

contactanyrequired

Associated contact, if any

senderIdentityanyrequired

Sender identity used for the conversation

messagesobject[]required

Request

curl -X GET "https://api.kibamail.com/v1/inbox/conversations/{conversationId}" \
  -H "Authorization: Bearer kb_your_api_key" \
  -H "Content-Type: application/json"

Response

Successfully retrieved conversation with messages.

{
  "object": "string",
  "id": "string",
  "subject": "string",
  "status": "string",
  "originType": "string",
  "originId": "string",
  "messageCount": 1,
  "unreadCount": 1,
  "lastMessageAt": "string",
  "createdAt": "string",
  "contact": null,
  "senderIdentity": null,
  "messages": [
    {
      "id": "string",
      "direction": "string",
      "from": "string",
      "to": "string",
      "subject": "string",
      "bodyHtml": null,
      "bodyText": null,
      "createdAt": "string"
    }
  ]
}