Search donors | DonorAtlas Partners API

curl -X POST https://api.donoratlas.com/v1/partners/search \
     -H "x-api-key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "search_query": "wealthy donors in New York who give to education"
}'

{
  "total_count": 1,
  "page_number": 1,
  "page_size": 1,
  "results": [
    {
      "id": "d1234567-89ab-4cde-f012-3456789abcde",
      "name": "Elizabeth Warren",
      "bio": "Philanthropist and education advocate based in New York City.",
      "city": "New York",
      "state": "NY",
      "giving_capacity": 5000000,
      "net_worth_min": 20000000,
      "net_worth_max": 30000000,
      "primary_photo": "https://donoratlas.com/photos/d1234567.jpg",
      "explanation": [
        "Located in New York",
        "High giving capacity",
        "Known for donations to education causes"
      ]
    }
  ],
  "sentenced_schema": "Donors located in New York with high giving capacity and a history of supporting education"
}

Search for donors using either natural language or structured search criteria. Set mode to ‘natural-language’ and provide search_query to describe donors in plain English, or set mode to ‘structured’ and provide donor_description with filters for location, giving capacity, net worth, affiliations, education, employment, political donations, and more. Returns paginated results with relevance explanations. Only person/donor search is supported; any nonprofit criteria are ignored. See the Donor Profile Schema guide for details on the donor data model.

Cost: 1 credit.

Search for donors using either natural language or structured search criteria. Set mode to 'natural-language' and provide search_query to describe donors in plain English, or set mode to 'structured' and provide donor_description with filters for location, giving capacity, net worth, affiliations, education, employment, political donations, and more. Returns paginated results with relevance explanations. Only person/donor search is supported; any nonprofit criteria are ignored. See the [Donor Profile Schema](/guides/donor-profile) guide for details on the donor data model. **Cost: 1 credit.**

Authentication

x-api-keystring

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

Request

This endpoint expects an object.

natural-languageobjectRequired

Search for donors using a natural language query. Describe the type of donors you are looking for in plain English. The query is parsed by a large language model into structured search criteria

structuredobjectRequired

Search for donors using structured filter criteria. Define filters for location, giving capacity, net worth, affiliations, education, employment, political donations, and more

Response

Successful Response

total_countinteger

Total number of matching donors

page_numberinteger

Current page number

page_sizeinteger

Results per page

resultslist of objects

Page of person results

sentenced_schemastring or null

Human-readable summary of the search criteria

Errors

400

Bad Request Error

402

Payment Required Error

422

Unprocessable Entity Error

503

Service Unavailable Error