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
      • POSTCreate a network
      • GETList all networks
      • POSTAdd a member
      • POSTAdd members in bulk
      • GETCheck bulk add progress
      • GETList donors in network
      • POSTFind connected prospects
      • POSTCheck donors against your network
      • GETCheck a donor against your network
      • POSTLook up any donor's connections
      • POSTRemove members
      • PUTRename a network
      • DELDelete a network
LogoLogo
DonorAtlasDashboard
API ReferenceNetworks

Find connected prospects

POST
https://api.donoratlas.com/v1/partners/networks/discover
POST
/v1/partners/networks/discover
$curl -X POST https://api.donoratlas.com/v1/partners/networks/discover \
>     -H "x-api-key: <apiKey>" \
>     -H "Content-Type: application/json" \
>     -d '{}'
1{
2  "prospects": [
3    {
4      "donor": {
5        "id": "donor_987654",
6        "name": "Emily Johnson",
7        "bio": "Philanthropist focused on education and healthcare initiatives.",
8        "city": "San Francisco",
9        "state": "CA",
10        "giving_capacity": 250000,
11        "net_worth_min": 5000000,
12        "net_worth_max": 10000000,
13        "primary_photo": "https://images.donoratlas.com/photos/emily_johnson.jpg"
14      },
15      "max_strength": 0.92,
16      "total_connections": 3,
17      "connections": [
18        {
19          "source_donor": {
20            "id": "donor_123456",
21            "name": "Michael Thompson",
22            "bio": "Board member at multiple nonprofits in the Bay Area.",
23            "city": "San Francisco",
24            "state": "CA",
25            "giving_capacity": 150000,
26            "net_worth_min": 3000000,
27            "net_worth_max": 7000000,
28            "primary_photo": "https://images.donoratlas.com/photos/michael_thompson.jpg"
29          },
30          "strength": 0.92,
31          "snippet": "Co-served on the board of Bay Area Education Fund for 5 years",
32          "connecting_entity_name": "Bay Area Education Fund",
33          "connecting_entity_type": "nonprofit",
34          "source_relationship": "sits_on_board_of",
35          "target_relationship": "sits_on_board_of",
36          "source_networks": [
37            {
38              "network_id": "network_001",
39              "name": "Bay Area Philanthropists",
40              "color": "blue"
41            }
42          ]
43        }
44      ]
45    }
46  ],
47  "has_more": true
48}
Search the entire DonorAtlas database for prospects connected to your network members, ranked by connection strength. Use this for open-ended discovery — it will surface the strongest connections across all donors. If you already have a specific list of prospects to evaluate, use 'Compare prospects to your network' instead. Optionally filter by specific members, networks, or minimum strength.
Was this page helpful?
Previous

Check donors against your network

Next
Built with

Search the entire DonorAtlas database for prospects connected to your network members, ranked by connection strength. Use this for open-ended discovery — it will surface the strongest connections across all donors. If you already have a specific list of prospects to evaluate, use ‘Compare prospects to your network’ instead. Optionally filter by specific members, networks, or minimum strength.

Authentication

x-api-keystring

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

Request

This endpoint expects an object.
in_network_donor_idslist of strings or nullOptional
Specific network members to consider. If omitted, all members of the specified networks are used
network_idslist of strings or nullOptional
Scope to these networks. If omitted, all team networks are used
limitintegerOptional1-100Defaults to 10
Maximum number of prospects to return
min_strengthdoubleOptional0.45-1Defaults to 0.45
Minimum connection strength, which must be at least 0.45. Connections below that threshold are not stored because they represent relationships that we've determined are too weak to be useful

Response

Successful Response
prospectslist of objects
has_moreboolean
Whether there are more prospects beyond the requested limit

Errors

422
Unprocessable Entity Error