Get metadata in bulk | DonorAtlas Partners API

Retrieve lightweight metadata for up to 100 donors by their DonorAtlas IDs. Returns last-updated dates, contact info availability, and enrichment status for all found donors, plus a list of any IDs that were not found.

Cost: Free.

Authentication

x-api-keystring

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

Request

This endpoint expects an object.

donor_idslist of stringsRequired

List of DonorAtlas donor IDs to retrieve metadata for (1-100)

Response

Successful Response

metadatalist of objects

List of donor metadata

not_foundlist of strings

Donor IDs that were not found

Errors

402

Payment Required Error

422

Unprocessable Entity Error

$	curl -X POST https://api.donoratlas.com/v1/partners/donors/metadata/batch \
>	-H "x-api-key: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"donor_ids": [
>	"abc123",
>	"def456"
>	]
>	}'

1	{
2	"metadata": [
3	{
4	"donor_id": "abc123",
5	"date_last_updated": "2025-12-01T00:00:00+00:00",
6	"has_mobile_phone": true,
7	"has_verified_email": true,
8	"is_enhanced": true,
9	"no_sources_found": true
10	}
11	],
12	"not_found": [
13	"def456"
14	]
15	}