---
title: "Retrieve conversation"
method: GET
path: "/v1/conversations/{id}"
tags: ["Conversations"]
---

# Retrieve conversation

`GET /v1/conversations/{id}`

Retrieves one conversation

## Path parameters

- `id` string, uuid, required

## Response `200`

Successful Response

- ExternalConversation
  - `customerId` string, uuid, required
  - `customer` ExternalCustomer
    - `id` string, uuid, required
    - `externalUserId` string, nullable
    - `companyId` string, uuid, nullable
    - `accountId` string, uuid, nullable
    - `account` WebCompanySchemasExternalAccount
      - `name` string, nullable
      - `email` string, nullable
      - `website` string, nullable
      - `externalId` string, nullable
      - `customFields` object, nullable
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `email` string, email, nullable
    - `phoneNumber` string, nullable
    - `customFields` object, nullable
    - `defaultSenders` CustomerDefaultSenders
      - `sms` string, nullable
      - `email` string, nullable
    - `lastLoginTime` string, date-time, nullable
    - `createdAt` string, date-time, required
    - `totalConversations` integer, nullable
    - `avgTimeToSolve` integer, nullable
    - `totalSessions` integer, nullable
    - `totalSessionTime` integer, nullable
    - `avgSessionTime` integer, required
  - `startedAt` string, date-time, required
  - `lastMessage` ExternalMessage
    - `id` integer, required
    - `side` string, required
    - `type` string, required
    - `createdAt` string, date-time, required
    - `sentAt` string, date-time, required
    - `agent` ExternalUser
      - `createdAt` string, date-time, nullable
      - `firstName` string, required
      - `lastName` string, nullable
      - `email` string, email, nullable
      - `profileUrl` string, uri, nullable
      - `accessTypes` UserAccessType[], nullable
      - `id` string, uuid, required
    - `customer` ExternalCustomer
      - `id` string, uuid, required
      - `externalUserId` string, nullable
      - `companyId` string, uuid, nullable
      - `accountId` string, uuid, nullable
      - `account` WebCompanySchemasExternalAccount
        - `name` string, nullable
        - `email` string, nullable
        - `website` string, nullable
        - `externalId` string, nullable
        - `customFields` object, nullable
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `email` string, email, nullable
      - `phoneNumber` string, nullable
      - `customFields` object, nullable
      - `defaultSenders` CustomerDefaultSenders
        - `sms` string, nullable
        - `email` string, nullable
      - `lastLoginTime` string, date-time, nullable
      - `createdAt` string, date-time, required
      - `totalConversations` integer, nullable
      - `avgTimeToSolve` integer, nullable
      - `totalSessions` integer, nullable
      - `totalSessionTime` integer, nullable
      - `avgSessionTime` integer, required
    - `text` string, required
    - `channel` string, nullable
    - `attachments` ExternalAttachment[]
      - `name` string, required
      - `url` string, required
      - `size` integer, nullable
    - `deliveryStatus` string, nullable
    - `failedReason` string, nullable
    - `deliveredAt` string, date-time, nullable
  - `createdAt` string, date-time, required
  - `closedAt` string, date-time, nullable
  - `closedBy` string, uuid, nullable
  - `assignedAt` string, date-time, nullable
  - `assignedBy` string, uuid, nullable
  - `browser` string, nullable
  - `operatingSystem` string, nullable
  - `assignedAgent` ExternalUser
    - `createdAt` string, date-time, nullable
    - `firstName` string, required
    - `lastName` string, nullable
    - `email` string, email, nullable
    - `profileUrl` string, uri, nullable
    - `accessTypes` UserAccessType[], nullable
    - `id` string, uuid, required
  - `number` integer, nullable
  - `csat` CSATResponse
    - `score` string, nullable
    - `comment` string, nullable
  - `statistics` ConversationStatistics
    - `firstResponseTime` integer, nullable
    - `avgResponseTime` integer, nullable
    - `totalResolutionTime` integer, nullable
  - `escalatedAt` string, date-time, nullable
  - `updatedBy` union
    - string, uuid
    - string
  - `assignedAgentId` union
    - string, uuid
    - string
  - `subject` string, nullable
  - `status` 'OPEN' | 'SNOOZED' | 'CLOSED' | 'PENDING'
  - `priority` 'NO_PRIORITY' | 'LOW' | 'MEDIUM' | 'HIGH' | 'URGENT'
  - `tags` union
    - string[]
    - string[]
  - `customFields` object, nullable
  - `snoozedUntil` string, date-time, nullable
  - `assignedTeamId` string, uuid, nullable
  - `assignedToZeus` boolean, nullable
  - `id` string, uuid, required
  - `startedChannel` string, nullable
  - `startedSubChannel` string, nullable

## Other responses

- `422` — Validation Error

---

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