Skip to main content
POST
Export voice calls
Use the voice call export API to download filtered call rows as a CSV file.

Required access

Body

string
default:"csv"
required
Export format. Currently only csv is supported.
object
Voice call filters to apply before exporting rows.
object
Optional object mapping voice-call custom field IDs to filter values.
string
Custom field value filter for the given Sagepilot custom field ID.
string
default:"UTC"
Timezone used for formatted datetime columns.
integer
default:"500000"
Maximum number of rows to stream in the CSV export.

Filters

string
Call status. Supported values include pending, ended, missed, failed, active, scheduled, or all.
string
Comma-separated call modes, such as ai, human, ai_to_human, or human_to_ai.
string
Call direction. Use inbound or outbound.
string
Comma-separated channel UUIDs. Find channel IDs in Settings > API Details > Channels. See Resource IDs.
string
Comma-separated channel kinds, such as voice or whatsapp.
string
Customer UUID to filter calls by.
string
Comma-separated human agent or AI agent UUIDs. Use current where the API request is associated with a user context. See Resource IDs.
string
Comma-separated team UUIDs. See Resource IDs.
string
Comma-separated disposition values.
string
Comma-separated terminal reasons, such as voice_mail.
string
Comma-separated tag IDs.
string
Comma-separated call sources, such as direct, journey, or campaign.
string
Comma-separated campaign IDs.
string
Comma-separated journey IDs.
string
Comma-separated messaging template IDs sent during the call.
string
Comma-separated sentiment values, such as positive, neutral, or negative.
string
Use true or false to filter by recording availability.
string
Use true or false to filter by transcript availability.
integer
Minimum call duration in seconds.
integer
Maximum call duration in seconds.
string
Date preset or explicit range. Supported values include today, yesterday, last_7_days, last_30_days, and start|end.
string
Date field used with date_range. Supported values are created_at, answered_at, and ended_at.
string
Field used for ordering. Supported values include created_at, answered_at, ended_at, and duration_seconds.
string
Sort direction. Use asc or desc.
string
Use true to return unassigned calls.

Default columns

The CSV includes these default columns, followed by enabled voice-call custom fields:
  • Call Code
  • Call ID
  • Direction
  • Mode
  • Status
  • Created At
  • Answered At
  • Ended At
  • Duration
  • Hangup Reason
  • Ended By
  • Customer Name
  • Customer Phone
  • Customer Email
  • Customer Company
  • From Number
  • To Number
  • Agent
  • Pilot
  • Team
  • Channel
  • Channel Type
  • Disposition
  • Disposition Set By
  • Summary
  • Sentiment
  • Recording URL
  • Has Transcript
  • Source
  • Campaign ID
  • Journey ID
  • Scheduled At
  • Scheduled By
  • Tags
  • Transcript

Notes

  • Use voice call export when you need row-level CSV data for calls, recordings, transcripts, dispositions, and call-level custom fields.
  • The endpoint appends enabled voice-call custom fields after the default CSV columns.