Export Batch CSV

Download all contacts and call outcomes as a CSV file

​

Endpoint

GET https://api.graine.ai/api/v1/batches/{batch_id}/export.csv

Downloads all contacts in a batch as a CSV file. The file includes every call_variables key from the uploaded contact data plus operational result columns.

​

Path Parameters

Parameter	Type	Required	Description
batch_id	string	Yes	Batch to export

​

Headers

Header	Required	Description
Authorization	Yes	Bearer gat_<token>

​

Response

Content-Type: text/csv

The CSV columns are dynamic — the contact data columns come from the call_variables keys you uploaded.

​

Fixed columns (always present)

Column	Description
phone_number	E.164 phone number
status	Final contact status
retry_count	Number of retry attempts
follow_up_count	Number of follow-up calls
last_attempted_at	Timestamp of last call attempt
next_retry_at	When next retry fires (empty if terminal)
last_call_status	Outcome of the most recent call attempt
last_execution_id	Execution ID of the most recent call
last_completed_at	Completion timestamp of most recent call
last_duration_seconds	Call duration in seconds
last_recording_url	Recording URL (if available)
last_hangup_by	Who ended the call: assistant or user
last_hangup_reason	Hangup reason string
last_total_cost	Cost in USD
last_summary	AI-generated call summary

​

Dynamic columns (from your data)

The columns from call_variables of your contacts are also included. For example, if your contacts have callee_name, current_plan, renewal_date, and premium in their call_variables, those four columns appear in the CSV as well.

​

Example CSV

phone_number,callee_name,current_plan,renewal_date,premium,status,retry_count,last_call_status,last_duration_seconds,last_summary
[phone],Rajesh Sharma,Basic Health,2026-07-01,12000,completed,1,completed,142,"Customer interested in Family Floater upgrade"
[phone],Priya Mehta,Family Floater,2026-06-15,28000,no_answer,3,no-answer,0,

​

Example Request

curl "https://api.graine.ai/api/v1/batches/btc_xyz001/export.csv" \
  -H "Authorization: Bearer gat_your_token" \
  --output batch_results.csv

import requests

url = "https://api.graine.ai/api/v1/batches/btc_xyz001/export.csv"
headers = { "Authorization": "Bearer gat_your_token" }

response = requests.get(url, headers=headers)
with open("batch_results.csv", "wb") as f:
    f.write(response.content)
print("Downloaded batch_results.csv")

Export is available at any time — even mid-batch. Contacts still in-flight will show their current status (e.g. pending, dispatched).