Check donors against your network | DonorAtlas Partners API

curl -X POST https://api.donoratlas.com/v1/partners/networks/connections \
     -H "x-api-key: <apiKey>" \
     -H "Content-Type: application/json" \
     -d '{
  "donor_ids": [
    "donor_12345",
    "donor_67890"
  ]
}'

{
  "results": [
    {
      "donor_id": "donor_12345",
      "max_strength": 0.92,
      "total_connections": 3,
      "connections": [
        {
          "source_donor": {
            "id": "network_member_001",
            "name": "Michael Thompson",
            "bio": "Board member of multiple nonprofits in the Bay Area.",
            "city": "San Francisco",
            "state": "CA",
            "giving_capacity": 750000,
            "net_worth_min": 5000000,
            "net_worth_max": 7000000,
            "primary_photo": "https://images.donoratlas.com/photos/network_member_001.jpg"
          },
          "strength": 0.92,
          "snippet": "Served together on the board of Bay Area Education Fund for 5 years",
          "connecting_entity_name": "Bay Area Education Fund",
          "connecting_entity_type": "nonprofit",
          "source_relationship": "sits_on_board_of",
          "target_relationship": "sits_on_board_of",
          "source_networks": [
            {
              "network_id": "network_01",
              "name": "Bay Area Philanthropists",
              "color": "blue"
            }
          ]
        }
      ],
      "donor": {
        "id": "donor_12345",
        "name": "Emily Johnson",
        "bio": "Philanthropist focused on education and healthcare initiatives.",
        "city": "San Francisco",
        "state": "CA",
        "giving_capacity": 500000,
        "net_worth_min": 2000000,
        "net_worth_max": 3000000,
        "primary_photo": "https://images.donoratlas.com/photos/donor_12345.jpg"
      }
    },
    {
      "donor_id": "donor_67890",
      "max_strength": 0,
      "total_connections": 0,
      "connections": [],
      "donor": {
        "id": "donor_67890",
        "name": "James Lee",
        "bio": "Entrepreneur and active supporter of environmental causes.",
        "city": "Seattle",
        "state": "WA",
        "giving_capacity": 300000,
        "net_worth_min": 1500000,
        "net_worth_max": 2500000,
        "primary_photo": "https://images.donoratlas.com/photos/donor_67890.jpg"
      }
    }
  ]
}

Submit a list of donor IDs and see how connected each one is to your network members. Returns every donor ranked by connection strength, including those with zero connections. This is the bulk version of ‘Check a donor against your network’.

Cost: 1 credit.

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

Prospect donor IDs to evaluate

in_network_donor_idslist of strings or nullOptional

Specific network members to compare against. 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

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

resultslist of objects

Errors

402

Payment Required Error

422

Unprocessable Entity Error