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
      • POSTSearch donors
LogoLogo
DonorAtlasDashboard
API ReferenceSearch

Search donors

POST
https://api.donoratlas.com/v1/partners/search
POST
/v1/partners/search
$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"
>}'
1{
2  "total_count": 1,
3  "page_number": 1,
4  "page_size": 1,
5  "results": [
6    {
7      "id": "d1234567-89ab-4cde-f012-3456789abcde",
8      "name": "Elizabeth Warren",
9      "bio": "Philanthropist and education advocate based in New York City.",
10      "city": "New York",
11      "state": "NY",
12      "giving_capacity": 5000000,
13      "net_worth_min": 20000000,
14      "net_worth_max": 30000000,
15      "primary_photo": "https://donoratlas.com/photos/elizabeth_warren.jpg",
16      "explanation": [
17        "Located in New York",
18        "Known for significant donations to education causes",
19        "High estimated giving capacity"
20      ]
21    }
22  ],
23  "sentenced_schema": "Search for wealthy donors located in New York with a history of giving to education."
24}
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.
Was this page helpful?
Previous
Built with

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.

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
OR
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
422
Unprocessable Entity Error
503
Service Unavailable Error

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