---
title: "Get Bulk Send CSV Template"
method: GET
path: "/api/v1/bulk_sends/csv_template"
tags: ["Bulk Send"]
---

# Get Bulk Send CSV Template

`GET /api/v1/bulk_sends/csv_template`

Fetches a CSV template that corresponds to the provided document template IDs. CSV templates are blank CSV files that have columns containing required and optional data that can be sent when creating a bulk send. Fields can be referenced by the field label. Example: [placeholder name]_[field label] could be something like customer_address or signer_company_name (if 'Customer' and 'Signer' were placeholder names for templates set up in SignWell).

## Query parameters

- `template_ids[]` string[], required — Specify one or more templates to generate a single blank CSV file that will contain available columns for your recipient data. The template_ids[] parameter is an array of template IDs (e.g.,`/?template_ids[]=5a67dbd7-928a-4ea0-a7e2-e476a0eb045f&template_ids[]=d7315111-c671-4b15-8354-c9a19bbaefa0`). Each ID should be a separate parameter in the query string.
- `base64` boolean — When true, returns the CSV as a base64-encoded string in a JSON response instead of a binary file download.

## Response `200`

successful

- BulkSendCsvTemplateResponse — Base64-encoded CSV template
  - `data` string, byte, required — Base64-encoded CSV content

## Other responses

- `401` — unauthorized
- `404` — not found
- `429` — rate limit exceeded

---

[API](https://skmtc.net/signwell/apis/signwell-developer-api.md) · [All operations](https://skmtc.net/signwell/apis/signwell-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signwell/signwell-developer-api/revisions/debef5796b62/schema)