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"
This returns a list of enrichments that match your query, each with an id you’ll use in the next step.

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 request_id. Check progress with:
curl "https://api.databar.ai/v1/tasks/YOUR_REQUEST_ID" \
  -H "x-apikey: YOUR_API_KEY"

Next steps