---
title: "Download Batch CSV Template"
api: "GET /v1/api/batch-calls/template"
description: "Download the CSV template for a batch call upload."
lastUpdated: "2026-10-29"
---

> **For AI agents:** the complete documentation index is at [llms.txt](https://trillet-ai.jamdesk.app/llms.txt). Append `.md` to any page URL for its markdown version.

### Headers

<ParamField header="x-workspace-id" type="string" required>
  Workspace identifier for the API.
</ParamField>

The response is a CSV file (`Content-Type: text/csv`, filename `batch-calls-template.csv`) with a header row and one example row:

```csv
phone_number,business,contact_name,service,date,amount,notes
"+12000000000","Trillet","John Smith","Premium Support","December 31st, 2024","$499","Phone numbers: US numbers can be 10 digits (2125551234). All other countries must include country code (Australia: 61393209000, UK: 442071234567)"
```

Only the phone number column is required by [Start Batch Calls](https://trillet-ai.jamdesk.app/v1/api-reference/endpoints/calls/batch/start). It may be named `phone_number`, `phone` or `Phone`. The other columns are examples: you can rename, remove or add columns, and each one is passed to the call as a dynamic variable (for example `{{contact_name}}`). Replace the example row with your contacts before uploading.

### Example

```bash
curl -X GET "https://api.trillet.ai/v1/api/batch-calls/template" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "x-workspace-id: YOUR_WORKSPACE_ID" \
  -o batch-template.csv
```


---

📦 **OpenAPI specs:** Every OpenAPI specification referenced by this documentation is available as a single download — https://trillet-ai.jamdesk.app/api-specs.zip
