Get multiple donors | DonorAtlas Partners API

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"
  ]
}'

{
  "donors": [
    {
      "date_last_updated": "2025-12-01",
      "donoratlas_url": "https://app.donoratlas.com/donor/abc123",
      "id": "abc123",
      "name": {
        "first": "string",
        "last": "string",
        "title": "string",
        "middle": "string",
        "suffix": "string"
      },
      "sex": "Male",
      "mailing_address": {
        "street_address": "string",
        "street_address_line_2": "string",
        "city": "string",
        "state": "string",
        "zip": "string"
      },
      "city": "string",
      "state": "string",
      "age": 45,
      "is_deceased": true,
      "religion": "Christian",
      "primary_photo_url": "string",
      "source_urls": [
        "https://example.com"
      ],
      "bio": [
        "string"
      ],
      "top_issues": [
        {
          "issue_tag": "AIDS",
          "description": "string"
        }
      ],
      "net_worth_min": 1000000,
      "net_worth_max": 5000000,
      "political_stats": {
        "capacity": 85000,
        "avg_amt": 250,
        "total_donation_count": 87,
        "total_amt": 100000,
        "per_year": {
          "2012": 1,
          "2014": 1,
          "2016": 1,
          "2018": 1,
          "2020": 1,
          "2022": 1,
          "2024": 1
        },
        "amt_to_democrats": 20000,
        "amt_to_republicans": 20000,
        "amt_to_libertarians": 20000,
        "amt_to_green_party": 20000,
        "amt_to_independents": 20000,
        "amt_to_no_party": 0,
        "amt_to_presidential": 20000,
        "amt_to_congressional": 10000,
        "amt_to_state_local": 50000
      },
      "nonprofit_stats": {
        "total_donation_count": 45,
        "capacity": {
          "predicted_annual_giving": 125000,
          "explanations": [
            {
              "title": "Real Estate Holdings",
              "reason": "Owns $2.5M property in Manhattan"
            }
          ]
        },
        "avg_amt": 5000,
        "total_amt_range": [
          "50000",
          "100000"
        ]
      },
      "education": [
        {
          "institution_name": "Harvard University",
          "institution_url": "string",
          "degree": "Bachelor of Arts",
          "graduation_year": 2015,
          "start_date": "2023-01-15",
          "end_date": "2023-01-15",
          "source_urls": [
            "www.example.com"
          ]
        }
      ],
      "work": [
        {
          "company_name": "Apple Inc.",
          "company_url": "string",
          "job_title": "Chief Executive Officer",
          "start_date": "2023-01-15",
          "end_date": "2023-01-15",
          "source_urls": [
            "www.example.com"
          ]
        }
      ],
      "board_affiliations": [
        {
          "name": "string",
          "title": "Treasurer",
          "source_urls": [
            "www.example.com"
          ],
          "probability": 0.95,
          "nonprofit_url": "string",
          "year_range": [
            "2020",
            "2025"
          ]
        }
      ],
      "donations": [
        {
          "name": "string",
          "source_urls": [
            "www.example.com"
          ],
          "probability": 0.95,
          "nonprofit_url": "string",
          "amount_range": [
            "250",
            "499"
          ],
          "year_range": [
            "2023",
            "2025"
          ]
        }
      ],
      "private_foundations": [
        {
          "name": "Smith Family Foundation",
          "relationship": "Trustee",
          "nonprofit_url": "string",
          "revenue": 250000,
          "assets": 5000000,
          "source_urls": [
            "www.example.com"
          ]
        }
      ]
    }
  ],
  "not_found": [
    "def456"
  ]
}

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.

Cost: 1 credit per donor.

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](/guides/donor-profile) guide for details on confidence scores, data sources, and financial fields. **Cost: 1 credit per donor.**

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

402

Payment Required Error

422

Unprocessable Entity Error