Sign in
logs

Export Voice Logs

Export the calls matching the current filters as a typed .xlsx / pure CSV.

Same filters, same crud query, same enrichment as list_calls — the file equals the screen by construction. Row cap {EXPORT_ROW_CAP}: above it the request 422s ("narrow your date range") rather than silently truncating. Every export writes a durable ExportAudit row (who/what/how many — never row contents).

get/api/v1/logs/voice/export

Query parameters

environment'production' | 'staging'

Environment an agent (and the conversations it handles) belongs to.

Vestigial since the staging clone was removed: every agent and every new conversation is PRODUCTION. The column is retained because historical rows still carry it and several snapshot filters key off it.

was_transferredboolean nullable
transfer_failedboolean nullable
was_missedboolean nullable
was_answeredboolean nullable
is_voicemailboolean nullable
transfer_destinationstring nullable
transfer_failure_reasonstring nullable
contact_sourcestring nullable
outcome'voicemail' | 'missed_by_system' | 'transferred' | 'handled_end_to_end' nullable
has_first_responseboolean nullable
has_endedboolean nullable
local_hour_of_dayinteger nullable

Filter to rows stamped at this tenant-local hour (0-23); heatmap cell drill.

Filter to rows stamped at this tenant-local hour (0-23); heatmap cell drill.

local_day_of_weekinteger nullable

Filter to rows stamped on this tenant-local weekday (0=Mon..6=Sun); heatmap cell drill.

Filter to rows stamped on this tenant-local weekday (0=Mon..6=Sun); heatmap cell drill.

bucketsstring[] nullable
dispositionsstring[] nullable
needs_owner_reviewboolean nullable
use_created_atboolean nullable

Deprecated - use date_field=created_at.

Deprecated - use date_field=created_at.

failed_transfer_destinationstring nullable
failed_transfer_tool_namestring nullable
attempted_transfer_destinationstring nullable
attempted_transfer_tool_namestring nullable
succeeded_transfer_destinationstring nullable
succeeded_transfer_tool_namestring nullable
unresolved_transfer_destinationstring nullable
unresolved_transfer_tool_namestring nullable
format'xlsx' | 'csv'

File format: xlsx or csv.

File format: xlsx or csv.

columnsstring[] nullable

Ordered visible column keys to export. Core identity columns (when/caller/hotel) always export. Unknown keys are a 422.

Ordered visible column keys to export. Core identity columns (when/caller/hotel) always export. Unknown keys are a 422.

metric_idsstring[] nullable

Custom metrics to export — two columns each (result, score).

Custom metrics to export — two columns each (result, score).

idsstring[] nullable

Export only these selected calls (still ANDed with filters).

Export only these selected calls (still ANDed with filters).

report_namestring nullable

Filename stem (sanitized to ASCII kebab).

Filename stem (sanitized to ASCII kebab).

context_labelstring nullable

Human filter description for the workbook context header.

Human filter description for the workbook context header.

limitinteger nullable
offsetinteger nullable
pageinteger nullable

Deprecated - use offset.

Deprecated - use offset.

per_pageinteger nullable

Deprecated - use limit.

Deprecated - use limit.

start_datestring date nullable
end_datestring date nullable
date_fieldstring nullable

Which timestamp the date range filters. Valid values differ per subject; an unknown one is a 422 listing them.

Which timestamp the date range filters. Valid values differ per subject; an unknown one is a 422 listing them.

date_fromstring date-time nullable

Deprecated - use start_date.

Deprecated - use start_date.

date_tostring date-time nullable

Deprecated - use end_date.

Deprecated - use end_date.

property_idsstring[] nullable
property_ids_excludestring[] nullable
include_considered_hotelsboolean nullable

Include hotels the conversation was only considered for, not just the one it was attributed to.

Include hotels the conversation was only considered for, not just the one it was attributed to.

agent_idstring uuid nullable
outcome_agent_refstring nullable
outcome_agent_refsstring[] nullable
outcome_agent_refs_excludestring[] nullable
outcome_agent_kind'ai_voice' | 'ai_text' | 'human' nullable
reviewedboolean nullable
statusstring nullable
has_booking_intentboolean nullable
has_bookingboolean nullable
booking_madeboolean nullable
booking_attributedboolean nullable
tag_idsstring[] nullable
countrystring nullable
is_after_hoursboolean nullable
population_filtersstring[] nullable

Named conversation-population filters: business_hours, min_call_25s, real_customer_message, exclude_spam_test, dedupe_24h.

Named conversation-population filters: business_hours, min_call_25s, real_customer_message, exclude_spam_test, dedupe_24h.

searchstring nullable
standard_filtersstring nullable
metric_filtersstring nullable
sort_bystring nullable
sort_order'asc' | 'desc' nullable
strictboolean

Reject filters this subject cannot apply with a 422, instead of returning a wider population and reporting them in ignored_filters.

Reject filters this subject cannot apply with a 422, instead of returning a wider population and reporting them in ignored_filters.

voice_agent_idstring uuid nullable

Deprecated - use agent_id.

Deprecated - use agent_id.

metric_idstring uuid nullable

Deprecated - use metric_filters.

Deprecated - use metric_filters.

metric_state'pass' | 'fail' | 'na' | 'not_run' | 'error' nullable

Deprecated - use metric_filters.

Deprecated - use metric_filters.

booking_intentboolean nullable

Deprecated - use has_booking_intent.

Deprecated - use has_booking_intent.

Response

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

{"stackTrail":"paths:/api/v1/logs/voice/export:get:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}

Changes

No recorded changes to this endpoint across all 2 revisions of this API.