---
title: "List conversations with guests, the ones waiting on a reply first, each with its guest, last message and booking chip (filter by status, unread, a search q, or customer_id for one guest's)"
method: GET
path: "/conversations"
tags: ["conversations"]
---

# List conversations with guests, the ones waiting on a reply first, each with its guest, last message and booking chip (filter by status, unread, a search q, or customer_id for one guest's)

`GET /conversations`

## Request

- Base URL: `https://daybag.io/api/v1`
- URL: `https://daybag.io/api/v1/conversations`
- Auth: HTTP bearer

## Query parameters

- `status` 'open' | 'done'
- `unread` boolean
- `q` string: Matches the guest's name or email, or words in the messages
- `customer_id` string, uuid
- `limit` integer

## Response `200`

Success

- object
  - `data` object[], required
    - `id` string, required
    - `status` 'open' | 'done', required
    - `last_message_at` string, required: ISO 8601 timestamp (UTC)
    - `outfitter_read_at` string, nullable, required: ISO 8601 timestamp (UTC)
    - `guest_read_at` string, nullable, required: ISO 8601 timestamp (UTC)
    - `snoozed_until` string, nullable, required: ISO 8601 timestamp (UTC)
    - `created_at` string, required: ISO 8601 timestamp (UTC)
    - `unread` boolean, required: A guest message is newer than outfitter_read_at
    - `needs_reply` boolean, required: The guest wrote last
    - `customer` object, nullable, required: Null on a pre-sale question
      - `id` string, required
      - `name` string, required
      - `email` string, required
    - `last_message` object, nullable, required
      - `id` string, required
      - `body` string, required
      - `direction` string, required
      - `sent_by` string, required
      - `channel` string, required
      - `kind` string, required
      - `created_at` string, required: ISO 8601 timestamp (UTC)
    - `booking` object, nullable, required: The guest's next upcoming booking, else their latest
      - `id` string, required
      - `reference` string, required
      - `starts_at` string, required: ISO 8601 timestamp (UTC)
      - `status` string, required
      - `offering` object, required
        - `name` string, required
        - `kind` 'class' | 'appointment' | 'rental', required: class: sessions with seats, from its calendar · appointment: times from its calendar or weekly hours · rental: inventory over periods

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/daybag/apis/daybooked-io-api.md) · [All operations](https://skmtc.dev/daybag/apis/daybooked-io-api/llms.txt) · [OpenAPI document](https://skmtc.dev/daybag/apis/daybooked-io-api/revisions/1f576dead370?raw)