For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DonorAtlasDashboard
  • Getting Started
    • Welcome
    • Authentication
    • Quickstart
  • Guides
    • Donor Profile Schema
    • Network
    • Credits & Billing
    • Error Handling
  • API Reference
      • GETGet a single donor
      • POSTGet multiple donors
      • GETGet donor metadata
      • POSTGet metadata in bulk
LogoLogo
DonorAtlasDashboard
API ReferenceDonors

Get multiple donors

POST
https://api.donoratlas.com/v1/partners/donors/batch
POST
/v1/partners/donors/batch
$curl -X POST https://api.donoratlas.com/v1/partners/donors/batch \
>     -H "x-api-key: <apiKey>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "donor_ids": [
>    "abc123",
>    "def456"
>  ]
>}'
1{
2  "donors": [
3    {
4      "date_last_updated": "2025-12-01",
5      "donoratlas_url": "https://app.donoratlas.com/donor/abc123",
6      "id": "abc123",
7      "name": {
8        "first": "string",
9        "last": "string",
10        "title": "string",
11        "middle": "string",
12        "suffix": "string"
13      },
14      "sex": "Male",
15      "mailing_address": {
16        "street_address": "string",
17        "street_address_line_2": "string",
18        "city": "string",
19        "state": "string",
20        "zip": "string"
21      },
22      "age": 45,
23      "is_deceased": true,
24      "religion": "Christian",
25      "primary_photo_url": "string",
26      "source_urls": [
27        "https://example.com"
28      ],
29      "bio": [
30        "string"
31      ],
32      "top_issues": [
33        {
34          "issue_tag": "AIDS",
35          "description": "string"
36        }
37      ],
38      "net_worth_min": 1000000,
39      "net_worth_max": 5000000,
40      "political_stats": {
41        "capacity": 85000,
42        "avg_amt": 250,
43        "total_donation_count": 87,
44        "total_amt": 100000,
45        "per_year": {
46          "2012": 1,
47          "2014": 1,
48          "2016": 1,
49          "2018": 1,
50          "2020": 1,
51          "2022": 1,
52          "2024": 1
53        },
54        "amt_to_democrats": 20000,
55        "amt_to_republicans": 20000,
56        "amt_to_libertarians": 20000,
57        "amt_to_green_party": 20000,
58        "amt_to_independents": 20000,
59        "amt_to_no_party": 0,
60        "amt_to_presidential": 20000,
61        "amt_to_congressional": 10000,
62        "amt_to_state_local": 50000
63      },
64      "nonprofit_stats": {
65        "total_donation_count": 45,
66        "capacity": {
67          "predicted_annual_giving": 125000,
68          "explanations": [
69            {
70              "title": "Real Estate Holdings",
71              "reason": "Owns $2.5M property in Manhattan"
72            }
73          ]
74        },
75        "avg_amt": 5000,
76        "total_amt_range": [
77          "50000",
78          "100000"
79        ]
80      },
81      "education": [
82        {
83          "institution_name": "Harvard University",
84          "institution_url": "string",
85          "degree": "Bachelor of Arts",
86          "graduation_year": 2015,
87          "start_date": "2023-01-15",
88          "end_date": "2023-01-15",
89          "source_urls": [
90            "www.example.com"
91          ]
92        }
93      ],
94      "work": [
95        {
96          "company_name": "Apple Inc.",
97          "company_url": "string",
98          "job_title": "Chief Executive Officer",
99          "start_date": "2023-01-15",
100          "end_date": "2023-01-15",
101          "source_urls": [
102            "www.example.com"
103          ]
104        }
105      ],
106      "board_affiliations": [
107        {
108          "name": "string",
109          "title": "Treasurer",
110          "source_urls": [
111            "www.example.com"
112          ],
113          "probability": 0.95,
114          "nonprofit_url": "string",
115          "year_range": [
116            "2020",
117            "2025"
118          ]
119        }
120      ],
121      "donations": [
122        {
123          "name": "string",
124          "source_urls": [
125            "www.example.com"
126          ],
127          "probability": 0.95,
128          "nonprofit_url": "string",
129          "amount_range": [
130            "250",
131            "499"
132          ],
133          "year_range": [
134            "2023",
135            "2025"
136          ]
137        }
138      ],
139      "private_foundations": [
140        {
141          "name": "Smith Family Foundation",
142          "relationship": "Trustee",
143          "nonprofit_url": "string",
144          "revenue": 250000,
145          "assets": 5000000,
146          "source_urls": [
147            "www.example.com"
148          ]
149        }
150      ]
151    }
152  ],
153  "not_found": [
154    "def456"
155  ]
156}

Retrieve full profiles for up to 100 donors by their DonorAtlas IDs. Returns all found donors plus a list of any IDs that were not found. Contact information is not included. See the Donor Profile Schema guide for details on confidence scores, data sources, and financial fields.

Was this page helpful?
Previous

Get donor metadata

Next
Built with

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 (1-100)

Response

Successful Response
donorslist of objects
List of donor profiles
not_foundlist of strings
Donor IDs that were not found

Errors

422
Unprocessable Entity Error