---
title: "Export Bookings"
method: GET
path: "/api/v1/bookings/export"
tags: ["bookings"]
deprecated: true
---

# Export Bookings

`GET /api/v1/bookings/export`

> **Deprecated.**

Export the bookings matching the current filters as typed .xlsx / CSV.

Same filters, same query, same sort as ``list_bookings_endpoint`` — the file
equals the screen by construction. Above the row cap the request 422s rather
than truncating. Booking-scoped custom metrics export two columns each,
resolved from each booking's own log-less result. Every export writes a
durable ExportAudit row (metadata only, never row contents).

## Query parameters

- `property` string[], nullable
- `originating_channel` OriginatingChannel[], nullable
- `property_exclude` string[], nullable
- `originating_channel_exclude` OriginatingChannel[], nullable
- `wh_source_id` string, nullable
- `channelstream` boolean, nullable
- `status_code` BookingStatusCode[], nullable
- `origin` IngestionSource[], nullable
- `attribution_tier` AttributionTier[], nullable
- `booked_from` string, date-time, nullable
- `booked_to` string, date-time, nullable
- `stay_from` string, date, nullable
- `stay_to` string, date, nullable
- `cancelled_from` string, date-time, nullable
- `cancelled_to` string, date-time, nullable
- `discrepancy` 'feed_conflicts_human' — Booking-anchored discrepancy filter values (PR 6/PR 7). ``judged_without_reservation`` is log-anchored (a stamped log with NO canonical reservation) and therefore lives on the logs surface — a bookings list cannot show a booking that doesn't exist.
- `unknown_commission` boolean, nullable
- `format` 'xlsx' | 'csv' — File format: xlsx or csv.
- `columns` string[], nullable — Ordered visible column keys to export. Core identity columns (booked / reservation / property) always export. Unknown keys 422.
- `metric_ids` string[], nullable — Booking-scoped custom metrics to export — two columns each (result, score), resolved from each booking's own log-less result.
- `report_name` string, nullable — Filename stem (sanitized to ASCII kebab).
- `context_label` string, nullable — Human filter description for the workbook context header.
- `limit` integer, nullable
- `offset` integer, nullable
- `page` integer, nullable — Deprecated - use offset.
- `per_page` integer, nullable — Deprecated - use limit.
- `start_date` string, date, nullable
- `end_date` string, date, nullable
- `date_field` string, nullable — Which timestamp the date range filters. Valid values differ per subject; an unknown one is a 422 listing them.
- `date_from` string, date-time, nullable — Deprecated - use start_date.
- `date_to` string, date-time, nullable — Deprecated - use end_date.
- `use_created_at` boolean, nullable — Deprecated - use date_field=created_at.
- `property_ids` string[], nullable
- `property_ids_exclude` string[], nullable
- `include_considered_hotels` boolean, nullable — Include hotels the conversation was only considered for, not just the one it was attributed to.
- `agent_id` string, uuid, nullable
- `outcome_agent_ref` string, nullable
- `outcome_agent_refs` string[], nullable
- `outcome_agent_refs_exclude` string[], nullable
- `outcome_agent_kind` 'ai_voice' | 'ai_text' | 'human', nullable
- `reviewed` boolean, nullable
- `status` string, nullable
- `has_booking_intent` boolean, nullable
- `has_booking` boolean, nullable
- `booking_made` boolean, nullable
- `booking_attributed` boolean, nullable
- `tag_ids` string[], nullable
- `country` string, nullable
- `is_after_hours` boolean, nullable
- `population_filters` string[], nullable — Named conversation-population filters: business_hours, min_call_25s, real_customer_message, exclude_spam_test, dedupe_24h.
- `search` string, nullable
- `standard_filters` string, nullable
- `metric_filters` string, nullable
- `sort_by` string, nullable
- `sort_order` 'asc' | 'desc', nullable
- `strict` boolean — Reject filters this subject cannot apply with a 422, instead of returning a wider population and reporting them in ignored_filters.
- `voice_agent_id` string, uuid, nullable — Deprecated - use agent_id.
- `metric_id` string, uuid, nullable — Deprecated - use metric_filters.
- `metric_state` 'pass' | 'fail' | 'na' | 'not_run' | 'error', nullable — Deprecated - use metric_filters.
- `booking_intent` boolean, nullable — Deprecated - use has_booking_intent.

## Response `200`

The export file (XLSX or CSV, per the `format` param).

- unknown

## Other responses

- `401` — Authentication required
- `422` — Unknown column/metric keys, or too many rows to export

---

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