---
title: "One conversation with its messages"
method: GET
path: "/v1/conversations/{id}"
---

# One conversation with its messages

`GET /v1/conversations/{id}`

## Request

- Base URL: `https://api.octapi.app`
- URL: `https://api.octapi.app/v1/conversations/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, uuid, required

## Response `200`

Default Response

- object
  - `conversation` object, required
    - `id` string, required
    - `status` 'bot' | 'human' | 'resolved', required
    - `channel` string, required
    - `window_expires_at` string, nullable, required
    - `assigned_staff_id` string, nullable, required
    - `handed_by` string, nullable, required
    - `handoff_reason` string, nullable, required
    - `agent_thinking` boolean, required
    - `surface` 'dm' | 'comment' | 'mention' | 'review'
    - `subject` unknown
    - `integration_id` string, nullable
    - `tone` string, nullable
    - `assigned_to_name` string, nullable, required
    - `contact_id` string, required
    - `created_at` string, required
    - `contact_name` string, nullable, required
    - `address` string, required
    - `opted_out` boolean, required
    - `locale` string, nullable
    - `avatar_key` string, nullable
    - `customer_id` string, nullable
    - `customer_name` string, nullable
    - `customer_notes` string, nullable
    - `customer_tags` string[], nullable
    - `referral` object, nullable
      - `source_id` string
      - `source_type` string
      - `source_url` string
      - `headline` string
      - `body` string
      - `ctwa_clid` string
    - `draft_text` string, nullable
    - `draft_at` string, nullable
    - `draft_basis` string, nullable
  - `messages` object[], required
    - `id` string, required
    - `direction` string, required
    - `sender` string, required
    - `type` string, required
    - `body` string, nullable, required
    - `status` string, nullable, required
    - `error` string, nullable, required
    - `explanation` string, nullable, required
    - `payload` unknown, required
    - `created_at` string, required
  - `notes` object[]
    - `id` string, required
    - `body` string, required
    - `mentions` string[], required
    - `created_at` string, required
    - `staff_id` string, nullable, required
    - `staff_name` string, nullable, required
  - `actions` unknown[], required
    - unknown
  - `cards` object, required
  - `assignments` object[]
    - `id` string, required
    - `staff_id` string, required
    - `staff_name` string, nullable, required
    - `by` string, required
    - `by_name` string, nullable, required
    - `reason` string, nullable, required
    - `from_at` string, required
    - `to_at` string, nullable, required
  - `appointments` unknown[], required
    - unknown
  - `related` unknown[], required
    - unknown

---

[API](https://skmtc.dev/octapi/apis/octapi-api.md) · [All operations](https://skmtc.dev/octapi/apis/octapi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/octapi/apis/octapi-api/revisions/580afda787d2?raw)