---
title: "Query conversations"
method: POST
path: "/v6/conversations/query"
tags: ["Conversations"]
---

# Query conversations

`POST /v6/conversations/query`

Query conversations for the authenticated user

## Request body

- ConversationQueryParam
  - `cursor` string, nullable — Cursor from the previous paginated response
  - `limit` integer — Page size, i.e. number of items to return per page
  - `sort` ConversationSort — Sort order for the items in the response.
    - `orderBy` 'CREATED_DATE_TIME' | 'SUBJECT' | 'EMAIL' | 'LAST_MESSAGE_CREATED_DATE_TIME' | 'LAST_MESSAGE_TEXT' — Sort column
    - `direction` 'ASC' | 'DESC' — Sort direction. Defaults to DESC
  - `filter` ConversationFilterParam — Filter for items in the response.
    - `subject` StringFilter — Name filter
      - `equal` string — Value - returns all records with specified field equal to this value.
      - `notEqual` string — Value - returns all records with specified field not equal to this value.
      - `greaterThan` string — Value - returns all records with specified field greater than to this value.
      - `greaterThanEqual` string — Value - returns all records with specified field greater than or equal to this value.
      - `lessThan` string — Value - returns all records with specified field less than to this value.
      - `lessThanEqual` string — Value - returns all records with specified field less than or equal to this value.
      - `contain` string — Value - returns all records with specified field containing this value.
    - `attachedEntity` AttachedEntityFilter — Attached entity filter
      - `id` Ids — Id filter - returns all entities with the following attachments.
        - `in` string[] — List of values to include.
    - `resolutionStatus` ResolutionStatusListFilter — Resolution status filter
      - `in` string[] — List of values to include.
      - `notIn` string[] — List of values to exclude.
    - `readStatus` ReadStatusListFilter — Read status filter
      - `in` string[] — List of values to include.
      - `notIn` string[] — List of values to exclude.
    - `authorUserId` StringFilter — Name filter
      - `equal` string — Value - returns all records with specified field equal to this value.
      - `notEqual` string — Value - returns all records with specified field not equal to this value.
      - `greaterThan` string — Value - returns all records with specified field greater than to this value.
      - `greaterThanEqual` string — Value - returns all records with specified field greater than or equal to this value.
      - `lessThan` string — Value - returns all records with specified field less than to this value.
      - `lessThanEqual` string — Value - returns all records with specified field less than or equal to this value.
      - `contain` string — Value - returns all records with specified field containing this value.
    - `authorEmail` StringFilter — Name filter
      - `equal` string — Value - returns all records with specified field equal to this value.
      - `notEqual` string — Value - returns all records with specified field not equal to this value.
      - `greaterThan` string — Value - returns all records with specified field greater than to this value.
      - `greaterThanEqual` string — Value - returns all records with specified field greater than or equal to this value.
      - `lessThan` string — Value - returns all records with specified field less than to this value.
      - `lessThanEqual` string — Value - returns all records with specified field less than or equal to this value.
      - `contain` string — Value - returns all records with specified field containing this value.
    - `company` CompanyIdFilter — Company filter
      - `in` string[] — Company IDs to include

## Response `200`

Success

- PaginatedResponseConversationGetDto
  - `result` 'SUCCESS' | 'FAILURE' — The result of the action performed.
  - `data` ConversationGetDto[] — The data generated by the action performed.
    - `id` string, required — Id of the conversation, required when updating an existing conversation
    - `attachedEntityId` string, nullable, required — Id of the entity associated with this conversation
    - `company` CompanyExpanded, required — Company associated with this conversation
      - `id` string, required — Id of the company
      - `name` string — Name of the company
    - `subject` string, required — Subject of the conversation
    - `author` AuthorInfo, required — List of authors who used this reaction
      - `userId` string, required — Id of the author
      - `email` string, nullable, required — Email of the author
    - `latestMessage` LatestMessageDto, required — The latest message associated with this conversation
      - `id` string, required — Id of the latest message
      - `author` AuthorInfo, required — List of authors who used this reaction
        - `userId` string, required — Id of the author
        - `email` string, nullable, required — Email of the author
      - `text` string, required — Contents of the latest message
    - `status` 'ACTIVE' | 'INACTIVE' | 'REMOVED', required — Status of the conversation
    - `readStatus` 'READ' | 'UNREAD', required — Read status of the conversation for the authenticated user
    - `resolutionStatus` 'OPEN' | 'CLOSED' | 'DRAFT', required — Resolution status of the conversation
    - `createdDateTime` string, date-time, required — Timestamp of when the conversation was created
    - `lastUpdatedDateTime` string, date-time, required — Timestamp of when the conversation was last updated
  - `cursor` ResponseCursor — Cursor to be used in your subsequent paginated request. Only populated if there are more pages available.
    - `after` string — After cursor - Fetches entities after this cursor. Useful for paging forwards.
    - `before` string — Before cursor - Fetches entities before this cursor. Useful for paging backwards.

## Other responses

- `400` — Bad request
- `401` — Not authenticated
- `403` — Not authorized
- `404` — Endpoint not found
- `500` — Internal server error

---

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