---
title: "List end user conversations"
method: GET
path: "/beta/endusers/{userId}/conversations"
tags: ["End Users", "Chatbots"]
---

# List end user conversations

`GET /beta/endusers/{userId}/conversations`

Lists conversations requested by an end user. <br/> Note: Custom attributes are not part of the response at this point. If you need to get custom attributes for a conversation use the [GET /conversations/{conversationId}](../Conversations/#tag/Conversations/operation/getConversationsConversationid) endpoint

## Path parameters

- `userId` string, uuid, required

## Query parameters

- `pageLimit` integer
- `pageKey` string

## Response `200`

The list of conversations requested by an EndUser

- ListEndUserConversationsOutput
  - `data` Conversation[]
    - union
      - 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
  - `meta` PaginationLinks
    - `previous` string — url
    - `next` string — url

## Other responses

- `400` — Invalid value for: path parameter userId, Invalid value extracted from request context, Invalid value for: query parameter pageLimit, Invalid value for: query parameter pageKey
- `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)