Credits & Billing

The Partners API uses a credit system. Your team has a credit balance for enhancements and a separate balance for exports.

Enhancement credits

Each person you submit for enhancement via PUT / consumes one enhancement credit, regardless of whether the enhancement succeeds or fails.

• Credits are deducted atomically when the request is accepted
• The meta field in the response tells you exactly how many credits were charged and how many remain
• If you don’t have enough credits for the full batch, the API processes as many as it can and returns partial: true
• If you have zero credits, the API returns 402 Payment Required

Partial processing

When your credit balance is lower than the batch size:

1
{
2
  "status": 202,
3
  "message": "Jobs submitted",
4
  "tracking_id_to_job_id": { "...": "..." },
5
  "meta": {
6
    "requested": 10,
7
    "processed": 3,
8
    "imports_charged": 3,
9
    "imports_remaining": 0,
10
    "partial": true,
11
    "partial_reason": "Only 3 credits remaining, but 10 persons requested"
12
  }
13
}

Only the first 3 persons are processed. The rest are silently dropped. Plan accordingly by checking imports_remaining after each request.

Export credits

Exports use a separate credit balance. Each unique donor exported via POST /export consumes one export credit.

• Re-exporting the same donor costs nothing (the system tracks which donors you’ve already exported)
• The response includes credits_used and exports_remaining
• If you don’t have enough export credits, the API returns 402 Payment Required

Checking your balance

There’s no dedicated “balance” endpoint. Instead, check your remaining credits from the meta field in enhancement responses or the exports_remaining field in export responses.

Features that don’t use credits

The following features are included with your API access at no per-use cost:

• Search — searching for donors
• Networks — creating networks, adding members, discovering connections, and lookups
• Lists — creating and managing donor lists
• Donor profiles — retrieving profiles for known donor IDs

Getting more credits

Contact your DonorAtlas account manager or email support@donoratlas.com to purchase additional credits.