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
LogoLogo
DonorAtlasDashboard
On this page
  • Getting your API key
  • Using your API key
  • Verifying your key
  • Security best practices
  • Rate limits
Getting Started

Authentication

How to authenticate with the Partners API
Was this page helpful?
Previous

Quickstart

Enhance your first contact in under 5 minutes
Next
Built with

All Partners API endpoints require an API key passed in the x-api-key header.

Getting your API key

API keys are provisioned by the DonorAtlas team. Contact support@donoratlas.com or reach out to your account manager to get one.

Each API key is scoped to a single team and has access to that team’s data, lists, networks, and credit balance.

Using your API key

Include the x-api-key header in every request:

$curl -X GET https://api.donoratlas.com/v1/partners/test \
>  -H "x-api-key: YOUR_API_KEY"

Verifying your key

Use the GET /test endpoint to verify your API key is valid. It returns 200 OK if the key is recognized and linked to an active team.

Security best practices

  • Never expose your API key in client-side code. API calls should be made from your server.
  • Rotate keys if you suspect they’ve been compromised. Contact support to issue a new key.
  • Store keys in environment variables or a secrets manager, not in source code.

Rate limits

The Partners API enforces the following rate limits:

LimitValue
Requests per second10
Burst limit10

If you exceed these limits, the API returns 429 Too Many Requests. Implement exponential backoff in your client.