---
title: "Get conversation"
method: GET
path: "/beta/conversations/{conversationId}"
tags: ["Conversations"]
---

# Get conversation

`GET /beta/conversations/{conversationId}`

Get a conversation by id.

## Path parameters

- `conversationId` integer, required

## Response `200`

The conversation

- GetConversationOutput
  - `data` union, required
    - AnonymizedConversation
      - `id` integer, required
      - `requesterId` string, uuid, required
      - `channel` string, required — values: [WhatsApp, Voicemail, WidgetChat, FacebookMessenger, Twitter, Email, ContactForm, Callback, PstnPhone, Sms, Messenger]
      - `createdAt` string, date-time, required
      - `direction` string — values: [Inbound, Internal, Outbound]
      - `state` string — values: [AwaitingPending, Closed, Open, Pending]
      - `stateUpdatedAt` string, date-time
      - `anonymizedAt` string, date-time, required
      - `link` union
        - EmailForward
          - `parentId` integer, required
        - FollowUp
          - `parentId` integer, required
        - SideConversation
          - `parentId` integer, required
      - `customAttributes` CustomAttribute[]
        - `id` string, uuid, required
        - `name` string, required
        - `identifier` string, required
        - `value` union, required — AttributeValue values: String[] if the type of the custom attribute is Select or String if the type of the custom attribute is Text
          - string[]
          - string
      - `transportExpiresAt` string, date-time
    - ChatConversation
      - `id` integer, required
      - `requesterId` string, uuid, required
      - `channel` string, required — values: [WhatsApp, Voicemail, WidgetChat, FacebookMessenger, Twitter, Email, ContactForm, Callback, PstnPhone, Sms, Messenger]
      - `createdAt` string, date-time, required
      - `direction` string — values: [Inbound, Internal, Outbound]
      - `state` string — values: [AwaitingPending, Closed, Open, Pending]
      - `stateUpdatedAt` string, date-time
      - `assignment` Assignment
        - `agentId` string, uuid, required
        - `assignedAt` string, date-time, required
      - `queue` Queue
        - `id` string, uuid, required
        - `queuedAt` string, date-time
      - `browserInfo` BrowserInfo
        - `name` string, required
        - `version` string
        - `ipAddress` string
        - `originatingUrl` string
      - `language` string
      - `link` union
        - EmailForward
          - `parentId` integer, required
        - FollowUp
          - `parentId` integer, required
        - SideConversation
          - `parentId` integer, required
      - `customAttributes` CustomAttribute[]
        - `id` string, uuid, required
        - `name` string, required
        - `identifier` string, required
        - `value` union, required — AttributeValue values: String[] if the type of the custom attribute is Select or String if the type of the custom attribute is Text
          - string[]
          - string
      - `transportExpiresAt` string, date-time
    - ContactFormConversation
      - `id` integer, required
      - `requesterId` string, uuid, required
      - `channel` string, required — values: [WhatsApp, Voicemail, WidgetChat, FacebookMessenger, Twitter, Email, ContactForm, Callback, PstnPhone, Sms, Messenger]
      - `createdAt` string, date-time, required
      - `direction` string — values: [Inbound, Internal, Outbound]
      - `state` string — values: [AwaitingPending, Closed, Open, Pending]
      - `stateUpdatedAt` string, date-time
      - `assignment` Assignment
        - `agentId` string, uuid, required
        - `assignedAt` string, date-time, required
      - `queue` Queue
        - `id` string, uuid, required
        - `queuedAt` string, date-time
      - `fromEmail` string, required
      - `toEmail` string
      - `integrationEmail` string
      - `language` string
      - `subject` string
      - `link` union
        - EmailForward
          - `parentId` integer, required
        - FollowUp
          - `parentId` integer, required
        - SideConversation
          - `parentId` integer, required
      - `customAttributes` CustomAttribute[]
        - `id` string, uuid, required
        - `name` string, required
        - `identifier` string, required
        - `value` union, required — AttributeValue values: String[] if the type of the custom attribute is Select or String if the type of the custom attribute is Text
          - string[]
          - string
      - `transportExpiresAt` string, date-time
    - EmailConversation
      - `id` integer, required
      - `requesterId` string, uuid, required
      - `channel` string, required — values: [WhatsApp, Voicemail, WidgetChat, FacebookMessenger, Twitter, Email, ContactForm, Callback, PstnPhone, Sms, Messenger]
      - `createdAt` string, date-time, required
      - `direction` string — values: [Inbound, Internal, Outbound]
      - `state` string — values: [AwaitingPending, Closed, Open, Pending]
      - `stateUpdatedAt` string, date-time
      - `assignment` Assignment
        - `agentId` string, uuid, required
        - `assignedAt` string, date-time, required
      - `queue` Queue
        - `id` string, uuid, required
        - `queuedAt` string, date-time
      - `toEmail` string, required
      - `fromEmail` string, required
      - `integrationEmail` string, required
      - `language` string
      - `subject` string
      - `link` union
        - EmailForward
          - `parentId` integer, required
        - FollowUp
          - `parentId` integer, required
        - SideConversation
          - `parentId` integer, required
      - `customAttributes` CustomAttribute[]
        - `id` string, uuid, required
        - `name` string, required
        - `identifier` string, required
        - `value` union, required — AttributeValue values: String[] if the type of the custom attribute is Select or String if the type of the custom attribute is Text
          - string[]
          - string
      - `transportExpiresAt` string, date-time
    - FacebookMessengerConversation
      - `id` integer, required
      - `requesterId` string, uuid, required
      - `channel` string, required — values: [WhatsApp, Voicemail, WidgetChat, FacebookMessenger, Twitter, Email, ContactForm, Callback, PstnPhone, Sms, Messenger]
      - `createdAt` string, date-time, required
      - `direction` string — values: [Inbound, Internal, Outbound]
      - `state` string — values: [AwaitingPending, Closed, Open, Pending]
      - `stateUpdatedAt` string, date-time
      - `assignment` Assignment
        - `agentId` string, uuid, required
        - `assignedAt` string, date-time, required
      - `queue` Queue
        - `id` string, uuid, required
        - `queuedAt` string, date-time
      - `link` union
        - EmailForward
          - `parentId` integer, required
        - FollowUp
          - `parentId` integer, required
        - SideConversation
          - `parentId` integer, required
      - `customAttributes` CustomAttribute[]
        - `id` string, uuid, required
        - `name` string, required
        - `identifier` string, required
        - `value` union, required — AttributeValue values: String[] if the type of the custom attribute is Select or String if the type of the custom attribute is Text
          - string[]
          - string
      - `transportExpiresAt` string, date-time
    - GenericConversation
      - `id` integer, required
      - `requesterId` string, uuid, required
      - `channel` string, required — values: [WhatsApp, Voicemail, WidgetChat, FacebookMessenger, Twitter, Email, ContactForm, Callback, PstnPhone, Sms, Messenger]
      - `createdAt` string, date-time, required
      - `fromContactPointId` string
      - `toContactPointId` string
      - `direction` string — values: [Inbound, Internal, Outbound]
      - `state` string — values: [AwaitingPending, Closed, Open, Pending]
      - `stateUpdatedAt` string, date-time
      - `assignment` Assignment
        - `agentId` string, uuid, required
        - `assignedAt` string, date-time, required
      - `queue` Queue
        - `id` string, uuid, required
        - `queuedAt` string, date-time
      - `link` union
        - EmailForward
          - `parentId` integer, required
        - FollowUp
          - `parentId` integer, required
        - SideConversation
          - `parentId` integer, required
      - `customAttributes` CustomAttribute[]
        - `id` string, uuid, required
        - `name` string, required
        - `identifier` string, required
        - `value` union, required — AttributeValue values: String[] if the type of the custom attribute is Select or String if the type of the custom attribute is Text
          - string[]
          - string
      - `transportExpiresAt` string, date-time
    - MessengerConversation
      - `id` integer, required
      - `requesterId` string, uuid, required
      - `channel` string, required — values: [WhatsApp, Voicemail, WidgetChat, FacebookMessenger, Twitter, Email, ContactForm, Callback, PstnPhone, Sms, Messenger]
      - `createdAt` string, date-time, required
      - `direction` string — values: [Inbound, Internal, Outbound]
      - `state` string — values: [AwaitingPending, Closed, Open, Pending]
      - `stateUpdatedAt` string, date-time
      - `assignment` Assignment
        - `agentId` string, uuid, required
        - `assignedAt` string, date-time, required
      - `queue` Queue
        - `id` string, uuid, required
        - `queuedAt` string, date-time
      - `browserInfo` BrowserInfo
        - `name` string, required
        - `version` string
        - `ipAddress` string
        - `originatingUrl` string
      - `language` string
      - `link` union
        - EmailForward
          - `parentId` integer, required
        - FollowUp
          - `parentId` integer, required
        - SideConversation
          - `parentId` integer, required
      - `customAttributes` CustomAttribute[]
        - `id` string, uuid, required
        - `name` string, required
        - `identifier` string, required
        - `value` union, required — AttributeValue values: String[] if the type of the custom attribute is Select or String if the type of the custom attribute is Text
          - string[]
          - string
      - `transportExpiresAt` string, date-time
    - PstnPhoneConversation
      - `id` integer, required
      - `requesterId` string, uuid, required
      - `channel` string, required — values: [WhatsApp, Voicemail, WidgetChat, FacebookMessenger, Twitter, Email, ContactForm, Callback, PstnPhone, Sms, Messenger]
      - `createdAt` string, date-time, required
      - `direction` string — values: [Inbound, Internal, Outbound]
      - `state` string — values: [AwaitingPending, Closed, Open, Pending]
      - `stateUpdatedAt` string, date-time
      - `assignment` Assignment
        - `agentId` string, uuid, required
        - `assignedAt` string, date-time, required
      - `queue` Queue
        - `id` string, uuid, required
        - `queuedAt` string, date-time
      - `link` union
        - EmailForward
          - `parentId` integer, required
        - FollowUp
          - `parentId` integer, required
        - SideConversation
          - `parentId` integer, required
      - `customAttributes` CustomAttribute[]
        - `id` string, uuid, required
        - `name` string, required
        - `identifier` string, required
        - `value` union, required — AttributeValue values: String[] if the type of the custom attribute is Select or String if the type of the custom attribute is Text
          - string[]
          - string
      - `transportExpiresAt` string, date-time
    - SmsConversation
      - `id` integer, required
      - `requesterId` string, uuid, required
      - `channel` string, required — values: [WhatsApp, Voicemail, WidgetChat, FacebookMessenger, Twitter, Email, ContactForm, Callback, PstnPhone, Sms, Messenger]
      - `createdAt` string, date-time, required
      - `direction` string — values: [Inbound, Internal, Outbound]
      - `state` string — values: [AwaitingPending, Closed, Open, Pending]
      - `stateUpdatedAt` string, date-time
      - `assignment` Assignment
        - `agentId` string, uuid, required
        - `assignedAt` string, date-time, required
      - `fromNumber` string
      - `toNumber` string
      - `queue` Queue
        - `id` string, uuid, required
        - `queuedAt` string, date-time
      - `link` union
        - EmailForward
          - `parentId` integer, required
        - FollowUp
          - `parentId` integer, required
        - SideConversation
          - `parentId` integer, required
      - `customAttributes` CustomAttribute[]
        - `id` string, uuid, required
        - `name` string, required
        - `identifier` string, required
        - `value` union, required — AttributeValue values: String[] if the type of the custom attribute is Select or String if the type of the custom attribute is Text
          - string[]
          - string
      - `transportExpiresAt` string, date-time
    - TwitterConversation
      - `id` integer, required
      - `requesterId` string, uuid, required
      - `channel` string, required — values: [WhatsApp, Voicemail, WidgetChat, FacebookMessenger, Twitter, Email, ContactForm, Callback, PstnPhone, Sms, Messenger]
      - `createdAt` string, date-time, required
      - `conversationType` string, required — values: [DirectMessage, Tweet]
      - `contactPointTwitterId` string
      - `endUserTwitterId` string
      - `direction` string — values: [Inbound, Internal, Outbound]
      - `state` string — values: [AwaitingPending, Closed, Open, Pending]
      - `stateUpdatedAt` string, date-time
      - `assignment` Assignment
        - `agentId` string, uuid, required
        - `assignedAt` string, date-time, required
      - `queue` Queue
        - `id` string, uuid, required
        - `queuedAt` string, date-time
      - `link` union
        - EmailForward
          - `parentId` integer, required
        - FollowUp
          - `parentId` integer, required
        - SideConversation
          - `parentId` integer, required
      - `customAttributes` CustomAttribute[]
        - `id` string, uuid, required
        - `name` string, required
        - `identifier` string, required
        - `value` union, required — AttributeValue values: String[] if the type of the custom attribute is Select or String if the type of the custom attribute is Text
          - string[]
          - string
      - `transportExpiresAt` string, date-time
    - WhatsAppConversation
      - `id` integer, required
      - `requesterId` string, uuid, required
      - `channel` string, required — values: [WhatsApp, Voicemail, WidgetChat, FacebookMessenger, Twitter, Email, ContactForm, Callback, PstnPhone, Sms, Messenger]
      - `createdAt` string, date-time, required
      - `direction` string — values: [Inbound, Internal, Outbound]
      - `state` string — values: [AwaitingPending, Closed, Open, Pending]
      - `stateUpdatedAt` string, date-time
      - `assignment` Assignment
        - `agentId` string, uuid, required
        - `assignedAt` string, date-time, required
      - `queue` Queue
        - `id` string, uuid, required
        - `queuedAt` string, date-time
      - `link` union
        - EmailForward
          - `parentId` integer, required
        - FollowUp
          - `parentId` integer, required
        - SideConversation
          - `parentId` integer, required
      - `customAttributes` CustomAttribute[]
        - `id` string, uuid, required
        - `name` string, required
        - `identifier` string, required
        - `value` union, required — AttributeValue values: String[] if the type of the custom attribute is Select or String if the type of the custom attribute is Text
          - string[]
          - string
      - `transportExpiresAt` string, date-time

## Other responses

- `400` — Invalid value for: path parameter conversationId, Invalid value extracted from request context
- `404` — An entity in this request could not be found
- `500` — Internal failure during request processing

---

[API](https://skmtc.net/dixa/apis/dixa-api.md) · [All operations](https://skmtc.net/dixa/apis/dixa-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dixa/dixa-api/versions/041e058483f0/schema)