---
title: "Concierge Brief"
method: GET
path: "/api/v1/concierge/brief"
tags: ["playbooks"]
---

# Concierge Brief

`GET /api/v1/concierge/brief`

Today's in-house and arriving guests, plus only real tasks.

With no ``list_id``, this is occupancy (PMS bookings for today) — not a
contact-list stay brief. ``list_id`` remains a CDO/debug override of the
older list-scoped path.

## Query parameters

- `list_id` string, uuid, nullable
- `property_id` string, uuid, nullable

## Response `200`

Successful Response

- ConciergeBriefResponse
  - `guests` ConciergeGuestBrief[], required
    - `customer_profile_id` string, uuid, nullable
    - `booking_record_id` string, uuid, nullable
    - `customer_name` string, nullable
    - `stay` ConciergeStay — A guest's current/next stay context, for the card header.
      - `status` 'in_house' | 'arriving', required
      - `checkin` string, date, required
      - `checkout` string, date, required
      - `nights` integer, required
      - `property_name` string, nullable
      - `days_until_arrival` integer, nullable
      - `room` string, nullable
      - `adults` integer, nullable
      - `children` integer, nullable
      - `bed_preference` string, nullable
    - `loyalty_tier` string, nullable
    - `returning` boolean
    - `travel` ConciergeTravel — Flights / ETA / pickup mined from the booking. None of these are invented.
      - `flight` string, nullable
      - `eta` string, nullable
      - `route` string, nullable
      - `departure_flight` string, nullable
      - `departure_time` string, nullable
      - `departure_route` string, nullable
      - `pickup` string, nullable
    - `open_count` integer, required
    - `findings` PlaybookTaskRead[], required
      - `id` string, uuid, required
      - `tenant_id` string, uuid, required
      - `customer_profile_id` string, uuid, nullable
      - `booking_record_id` string, uuid, nullable
      - `customer_name` string, nullable
      - `list_id` string, uuid, nullable
      - `source_playbook_id` string, uuid, nullable
      - `source_run_id` string, uuid, nullable
      - `title` string, required
      - `body` string, nullable
      - `category` string, nullable
      - `source_label` string, nullable
      - `property_id` string, uuid, nullable
      - `property_name` string, nullable
      - `due_at` string, date-time, nullable
      - `department` string, nullable
      - `assignee_kind` string
      - `owner_label` string, nullable
      - `blocked` boolean
      - `priority` string, nullable
      - `status` 'open' | 'done', required — A GM task raised by a Playbook: to-do (open) or done.
      - `assigned_user_id` string, uuid, nullable
      - `completed_at` string, date-time, nullable
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `completable` boolean
  - `properties` ConciergePropertyRef[]
    - `id` string, uuid, required
    - `name` string, required
    - `open_count` integer
  - `board_state` 'nothing_set_up' | 'stay_live_no_briefs' | 'preparing' | 'no_moments' | 'no_occupancy' | 'ready', required
  - `stay` ConciergeBoardStay — The stay this board is about — named in English, with the hotel.
    - `id` string, uuid, required
    - `name` string, required
    - `hotel_name` string, nullable
    - `guest_count` integer
    - `briefs_started` boolean
  - `open_count` integer
  - `guest_count` integer

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/getanana/apis/cleon-api.md) · [All operations](https://skmtc.dev/getanana/apis/cleon-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getanana/cleon-api/revisions/c0f54348e251/schema)