---
title: "The inbox"
method: GET
path: "/v1/conversations"
---

# The inbox

`GET /v1/conversations`

## Request

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

## Query parameters

- `status` 'bot' | 'human' | 'resolved'
- `channel` string
- `open` boolean
- `assigned` 'me' | 'none'
- `insight` 'handled' | 'stepped_in' | 'booked' | 'no_show'
- `days` integer

## Response `200`

Default Response

- object
  - `conversations` object[], required
    - `id` string, required
    - `contact_name` string, nullable, required
    - `address` string, required
    - `status` 'bot' | 'human' | 'resolved', required
    - `channel` string, required
    - `surface` string
    - `rating` number, nullable
    - `tone` string, nullable
    - `assigned_staff_id` string, nullable, required
    - `assigned_to_name` string, nullable, required
    - `window_expires_at` string, nullable, required
    - `agent_thinking` boolean, required
    - `last_message_at` string, nullable, required
    - `last_message` string, nullable, required
    - `last_direction` string, nullable, required
    - `unread` number, required

---

[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)