Check a donor against your network | DonorAtlas Partners API

{
  "donor": {
    "id": "d1234567-89ab-4cde-f012-3456789abcde",
    "name": "Emily Johnson",
    "bio": "Philanthropist focused on education and healthcare initiatives.",
    "city": "Seattle",
    "state": "WA",
    "giving_capacity": 250000,
    "net_worth_min": 5000000,
    "net_worth_max": 7500000,
    "primary_photo": "https://images.donoratlas.com/photos/d1234567.jpg"
  },
  "in_network": true,
  "total_connections": 3,
  "max_strength": 0.92,
  "connections": [
    {
      "source_donor": {
        "id": "n9876543-21ba-4fed-c210-9876543fedcb",
        "name": "Michael Thompson",
        "bio": "Board member at multiple nonprofits in the Seattle area.",
        "city": "Seattle",
        "state": "WA",
        "giving_capacity": 150000,
        "net_worth_min": 3000000,
        "net_worth_max": 4500000,
        "primary_photo": "https://images.donoratlas.com/photos/n9876543.jpg"
      },
      "strength": 0.89,
      "snippet": "Co-served on board for 5 years",
      "connecting_entity_name": "Seattle Education Foundation",
      "connecting_entity_type": "nonprofit",
      "source_relationship": "sits_on_board_of",
      "target_relationship": "sits_on_board_of",
      "source_networks": [
        {
          "network_id": "net-001",
          "name": "Seattle Philanthropy Network",
          "color": "teal"
        }
      ]
    },
    {
      "source_donor": {
        "id": "n1239874-56ab-4cde-f789-123456789abc",
        "name": "Sarah Lee",
        "bio": "Corporate executive and active donor.",
        "city": "Bellevue",
        "state": "WA",
        "giving_capacity": 200000,
        "net_worth_min": 4000000,
        "net_worth_max": 6000000,
        "primary_photo": "https://images.donoratlas.com/photos/n1239874.jpg"
      },
      "strength": 0.92,
      "snippet": "Worked together at TechCorp for 3 years",
      "connecting_entity_name": "TechCorp",
      "connecting_entity_type": "company",
      "source_relationship": "works_for",
      "target_relationship": "worked_for",
      "source_networks": [
        {
          "network_id": "net-002",
          "name": "Tech Leaders Network",
          "color": "blue"
        }
      ]
    },
    {
      "source_donor": {
        "id": "n4563217-89cd-4ef0-a123-456789abcdef",
        "name": "David Kim",
        "bio": "Alumni association president and community leader.",
        "city": "Seattle",
        "state": "WA",
        "giving_capacity": 100000,
        "net_worth_min": 2000000,
        "net_worth_max": 3500000,
        "primary_photo": "https://images.donoratlas.com/photos/n4563217.jpg"
      },
      "strength": 0.75,
      "snippet": "Alumni of University of Washington",
      "connecting_entity_name": "University of Washington",
      "connecting_entity_type": "school",
      "source_relationship": "alumnus_of",
      "target_relationship": "alumnus_of",
      "source_networks": [
        {
          "network_id": "net-003",
          "name": "UW Alumni Network",
          "color": "green"
        }
      ]
    }
  ],
  "member_of_networks": [
    {
      "network_id": "net-001",
      "name": "Seattle Philanthropy Network",
      "color": "teal",
      "created_at": "2022-05-10T14:22:00Z"
    },
    {
      "network_id": "net-004",
      "name": "Healthcare Donors Circle",
      "color": "rose",
      "created_at": "2023-01-15T09:45:00Z"
    }
  ]
}

See how a single donor is connected to your network members. Returns whether they’re a member, which networks they belong to, and all connections to people in your network.

Cost: 1 credit.

Authentication

x-api-keystring

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

Path parameters

donor_idstringRequired

Query parameters

network_idslist of strings or nullOptional

Scope to specific networks

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

donorobject or null

Donor profile. Null if the donor ID was not found

in_networkbooleanDefaults to false

total_connectionsintegerDefaults to 0

max_strengthdoubleDefaults to 0

connectionslist of objects

member_of_networkslist of objects

Errors

402

Payment Required Error

422

Unprocessable Entity Error

$	curl https://api.donoratlas.com/v1/partners/networks/donors/donor_id/connections \
>	-H "x-api-key: <apiKey>" \
>	-H "Content-Type: application/json"