Export donors to CSV or XLSX | DonorAtlas Partners API

Export donor data to a file. Provide either a list ID or specific donor IDs as the source. Specify the fields to include (see the DASpreadsheetFieldName enum for valid values). All exports run synchronously and return a presigned download URL.

Cost: 1 credit per donor exported.

Authentication

x-api-keystring

Your DonorAtlas API key. Contact support@donoratlas.com to get started.

Request

This endpoint expects an object.

sourceobjectRequired

Export source — either a list ID or specific donor IDs

export_typeenumRequired

Export format: ‘csv’ or ‘xlsx’

fieldslist of nullable enumsRequired

Fields to include in the export

Response

Successful Response

export_idstring

Unique export identifier

credits_chargedinteger

Number of Partner API export credits consumed

exports_credits_remaininginteger

Export Partner API credits remaining after this export

download_urlstring or null

Presigned download URL

Errors

400

Bad Request Error

402

Payment Required Error

422

Unprocessable Entity Error

$	curl -X POST https://api.donoratlas.com/v1/partners/exports \
>	-H "x-api-key: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"source": {
>	"list_id": "a1b2c3d4e5f6g7h8i9j0"
>	},
>	"export_type": "csv",
>	"fields": [
>	"First",
>	"Last",
>	"Best Verified Email",
>	"City",
>	"State",
>	"DonorAtlas URL"
>	]
>	}'

1	{
2	"export_id": "e7f3a9b2-4c1d-4f8e-9a2b-3d5f6e7c8a9b",
3	"credits_charged": 150,
4	"exports_credits_remaining": 4850,
5	"download_url": "https://s3.amazonaws.com/donoratlas-exports/exports/e7f3a9b2-4c1d-4f8e-9a2b-3d5f6e7c8a9b.csv?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20240601%2Fus-east-1%2Fs3%2Faws4_"
6	}