---
title: "Listar"
method: GET
path: "/v2/session"
tags: ["Conversas"]
---

# Listar

`GET /v2/session`

Listagem paginada de conversas.

## Query parameters

- `Status` string[]
- `DepartmentId` string, uuid
- `UserId` string, uuid
- `TagsId` string[]
- `TagsName` string[]
- `ChannelsId` string[]
- `ContactId` string, uuid
- `EndAt.Before` string, date-time
- `EndAt.After` string, date-time
- `ActiveAt.Before` string, date-time
- `ActiveAt.After` string, date-time
- `LastInteractionAt.Before` string, date-time
- `LastInteractionAt.After` string, date-time
- `IncludeDetails` string[]
- `Metadata` object
- `Type` 'INDIVIDUAL' | 'GROUP'
- `CreatedAt.Before` string, date-time
- `CreatedAt.After` string, date-time
- `UpdatedAt.Before` string, date-time
- `UpdatedAt.After` string, date-time
- `PageNumber` integer
- `PageSize` integer
- `OrderBy` string
- `OrderDirection` 'ASCENDING' | 'DESCENDING'

## Response `200`

Success

- PublicSessionDTOV2PublicPageListDTO
  - `pageNumber` integer — Número da página a ser obtida.
  - `pageSize` integer — Tamanho da página a ser obtida.
  - `orderBy` string, nullable — Nome do campo para ser utilizado como pivô da ordenação.
  - `orderDirection` 'ASCENDING' | 'DESCENDING', nullable — Determina se a ordenação deve ser crescente ou decrescente.
  - `items` PublicSessionDTOV2[], nullable
    - `id` string, uuid
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `startAt` string, date-time
    - `endAt` string, date-time, nullable
    - `status` 'UNDEFINED' | 'STARTED' | 'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'HIDDEN'
    - `companyId` string, uuid
    - `contactId` string, uuid, nullable
    - `channelId` string, uuid
    - `departmentId` string, uuid, nullable
    - `userId` string, uuid, nullable
    - `previewUrl` string, nullable
    - `title` string, nullable
    - `number` string, nullable
    - `utm` PublicUtmDTO
      - `sourceId` string, nullable
      - `source` string, nullable
      - `clid` string, nullable
      - `medium` string, nullable
      - `campaign` string, nullable
      - `content` string, nullable
      - `headline` string, nullable
      - `term` string, nullable
      - `referralUrl` string, nullable
    - `origin` string, nullable
    - `contactDetails` PublicContactDataDTO
      - `id` string, uuid, nullable
      - `name` string, nullable
      - `pictureUrl` string, nullable
      - `phonenumber` string, nullable
      - `instagram` string, nullable
      - `phonenumberFormatted` string, nullable
      - `tagsId` string[], nullable
      - `tagsName` string[], nullable
      - `status` 'ACTIVE' | 'ARCHIVED' | 'BLOCKED' | 'UNDEFINED'
    - `agentDetails` PublicAgentDataDTO
      - `id` string, uuid
      - `userId` string, uuid
      - `name` string, nullable
      - `shortName` string, nullable
      - `phoneNumber` string, nullable
      - `email` string, nullable
      - `pictureFileId` string, uuid, nullable
      - `pictureUrl` string, nullable
    - `channelDetails` PublicChannelIdentityDTO
      - `humanId` string, nullable
      - `platform` string, nullable
      - `provider` string, nullable
      - `providerVariable` string, nullable
      - `pictureUrl` string, nullable
      - `displayName` string, nullable
    - `departmentDetails` PublicDepartmentDataDTO
      - `id` string, uuid
      - `companyId` string, uuid
      - `name` string, nullable
      - `description` string, nullable
      - `isDefault` boolean
      - `isSupervisor` boolean
    - `classification` PublicSessionClassificationDTO
      - `id` string, uuid
      - `category` 'UNDEFINED' | 'WON' | 'LOST' | 'INFO' | 'OTHER'
      - `categoryDescription` string, nullable
      - `amount` number, double
      - `categoryName` string, nullable
    - `statusDescription` string, nullable
    - `timeService` string, nullable
    - `timeWait` string, nullable
    - `firstResponseAt` string, date-time, nullable
    - `botId` string, uuid, nullable
    - `unreadCount` integer
    - `lastMessageText` string, nullable
    - `lastInteractionDate` string, date-time, nullable
    - `lastMessageOut` string, date-time, nullable
    - `lastMessageIn` string, date-time, nullable
    - `windowStatus` 'ACTIVE' | 'EXPIRED' | 'NOT_STARTED'
    - `metadata` object, nullable
    - `channelType` 'GUPSHUP_WHATSAPP' | 'DIALOG360_WHATSAPP' | 'CLOUDAPI_WHATSAPP' | 'ZAPI_WHATSAPP' | 'EVOLUTIONAPI_WHATSAPP' | 'INSTAGRAM' | 'MESSENGER', nullable
    - `type` 'INDIVIDUAL' | 'GROUP', nullable
  - `totalItems` integer
  - `totalPages` integer
  - `hasMorePages` boolean

## Other responses

- `500` — Server Error

---

[API](https://skmtc.net/wts/apis/core.md) · [All operations](https://skmtc.net/wts/apis/core/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/wts/core/versions/1efd0a6ba643/schema)