Skip to main content

​
1. Get your API key

Log in to your Databar workspace and navigate to Integrations to find your API key.
To use the REST API, you may need to schedule a call with us first. Contact info@databar.ai for access.

​
2. Verify your key

Test that your API key works by fetching your account info: 
curl https://api.databar.ai/v1/user/me \
  -H "x-apikey: YOUR_API_KEY"
You should receive a response like: 
{
  "first_name": "David",
  "email": "david@databar.ai",
  "balance": 100.0,
  "plan": "Pro"
}

​
3. Search for an enrichment

Find available enrichments by searching with a keyword: 
curl "https://api.databar.ai/v1/enrichments/?q=email" \
  -H "x-apikey: YOUR_API_KEY"

​
4. Run an enrichment

Once you have an enrichment ID, run it with the required parameters: 
curl -X POST "https://api.databar.ai/v1/enrichments/123/run" \
  -H "x-apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"params": {"email": "test@example.com"}}'

​
5. Run in bulk

For batch processing, use the bulk endpoint: 
curl -X POST "https://api.databar.ai/v1/enrichments/123/bulk-run" \
  -H "x-apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"params": [{"email": "a@example.com"}, {"email": "b@example.com"}]}'
Bulk operations return a task_id. Check progress with: 
curl "https://api.databar.ai/v1/tasks/YOUR_TASK_ID" \
  -H "x-apikey: YOUR_API_KEY"
Task data is stored for 24 hours after completion. Make sure to retrieve your results before they expire.

​
Next steps

API Reference

Explore all endpoints with request and response examples.

Python SDK

Full SDK reference with enrichments, waterfalls, tables, and error handling.

Enrich leads

Walkthrough: enrich a list of leads with company and contact data.

Waterfall email finder

Walkthrough: find emails using multiple providers with automatic fallback.