---
title: "Get conversation"
method: GET
path: "/api/v4/messaging/conversations/{conversation_id}"
tags: ["Messaging"]
---

# Get conversation

`GET /api/v4/messaging/conversations/{conversation_id}`

Returns detailed information about a specific conversation.

## Path parameters

- `conversation_id` string, uuid, required

## Response `200`

OK

- object
  - `conversation` Conversation
    - `id` string, uuid — The unique identifier of the conversation.
    - `channel_profile` ChannelProfileShort
      - `id` integer — The unique identifier of the channel profile.
      - `channel` 'chat' | 'facebook' | 'instagram' | 'telegram' | 'viber' | 'whatsapp' — The channel associated with the profile.
      - `identifier` string, nullable — Channel profile identifier (for WhatsApp, the phone number).
      - `name` string — The name of the channel profile.
    - `contact_channel_account` ChannelAccount
      - `id` string, uuid — The unique identifier of the channel account.
      - `channel` 'chat' | 'facebook' | 'instagram' | 'telegram' | 'viber' | 'whatsapp' — The messaging channel.
      - `identifier` string — Channel-specific identifier of the contact.
      - `data` object — Additional channel data.
        - `name` string, nullable, required — Display name of the contact.
        - `username` string, nullable — Channel username when applicable.
    - `user` UserShort
      - `id` integer — The unique identifier of the user.
      - `name` string — The name of the user.
      - `email` string, email — The email address of the user.
    - `flow` FlowShort
      - `id` string, uuid — The unique identifier of the flow.
      - `name` string — The name of the flow.
    - `queue` QueueShort
      - `id` integer — The unique identifier of the queue.
      - `name` string — The name of the queue.
    - `status` 'initial' | 'active' | 'archived' | 'business_initiated' | 'business_initiated_waiting' | 'contact_disconnected' | 'dropped' | 'flow_ai_waiting' | 'flow_controlled' | 'flow_initiated' | 'flow_initiated_waiting' | 'flow_waiting' | 'force_closed' | 'forwarding' | 'rejected' | 'ringing' | 'system_initiated_waiting' | 'terminated' | 'waiting' | 'window_waiting' — Current status of the conversation.
    - `created_at` string, date-time — Timestamp when the conversation was created (ISO 8601).
    - `updated_at` string, date-time — Timestamp when the conversation was last updated (ISO 8601).

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `429` — Too many requests

---

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