Back to Docs

Waterfall Enrichment

Chain multiple providers with automatic fallback.

Request
→
Provider 1
→ fail →
Provider 2
→
Result

Creating a Waterfall

curl -X POST https://api.leadmagic.io/v1/waterfalls \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Email Finder Waterfall",
  "type": "email_finder",
  "steps": [
    {"vendorId": "leadmagic", "priority": 1},
    {"vendorId": "findymail", "priority": 2}
  ]
}'

Cost Optimization

Position your cheapest providers first. Expensive providers should be fallbacks.

AuthenticationAPI Reference