ईमेल सत्यापन API जो बस काम करता है

ऑथेंटिकेशन

हर अनुरोध पर अपनी API कुंजी को Authorization हेडर में bearer टोकन के रूप में भेजें। कुंजियाँ अपने सर्वर पर रखें। इन्हें कभी ब्राउज़र कोड या मोबाइल ऐप में न डालें।

Authorization: Bearer YOUR_API_KEY

हर एंडपॉइंट का बेस URL https://bouncebell.com/api/v1 है।

एक पते का सत्यापन करें

GET https://bouncebell.com/api/v1/verify

उदाहरण

curl "https://bouncebell.com/api/v1/verify?email=rini.elizabeth%40acme-foods.example" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "email": "rini.elizabeth@acme-foods.example",
  "status": "valid",
  "reason": "mailbox_exists",
  "domain": "acme-foods.example",
  "mx_record": "mx1.acme-foods.example",
  "disposable": false,
  "role": false,
  "free_provider": false,
  "catch_all": false,
  "did_you_mean": null,
  "checked_at": "2026-10-30T09:30:12Z",
  "credits_used": 1
}

नतीजे के फ़ील्ड

स्थितियाँ

बैच

एक अनुरोध में अधिकतम 1,00,000 पते भेजें। बैच बैकग्राउंड में चलता है; इसकी स्थिति पोल करें या callback_url दें, बैच पूरा होने पर हम उसे कॉल करेंगे।

बैच बनाएँ

POST https://bouncebell.com/api/v1/batches

curl -X POST "https://bouncebell.com/api/v1/batches" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "October import", "emails": ["a@example.com", "b@example.com"],
       "callback_url": "https://yourapp.example/hooks/bouncebell"}'

{ "id": "bat_8f2k1q3m9x7w4p", "status": "queued", "total": 2, "done": 0 }

बैच बनाते समय हर यूनिक पते के क्रेडिट रोक लिए जाते हैं, और बैच पूरा होने पर अज्ञात नतीजों के क्रेडिट वापस कर दिए जाते हैं। कॉलबैक को {"event": "batch.completed", "batch_id": "...", "status": "done", "counts": {...}} के साथ एक POST मिलता है। कॉलबैक URL में HTTPS होना ज़रूरी है।

प्रगति देखें

GET https://bouncebell.com/api/v1/batches/{id}

{ "id": "bat_8f2k1q3m9x7w4p", "status": "running", "total": 2, "done": 1 }

स्थिति queued, running या done होती है। done होने पर जवाब में स्थिति के अनुसार counts भी होते हैं।

नतीजे डाउनलोड करें

GET https://bouncebell.com/api/v1/batches/{id}/results

डिफ़ॉल्ट रूप से JSON लौटाता है। CSV फ़ाइल के लिए ?format=csv जोड़ें। हर पंक्ति में वही फ़ील्ड होते हैं जो एकल जाँच में होते हैं।

क्रेडिट

GET https://bouncebell.com/api/v1/credits

{ "credits_remaining": 33420 }

एरर और सीमाएँ

एरर होने पर एक JSON बॉडी मिलती है, जिसमें error कोड और पढ़ने योग्य message होता है।

एकल जाँचें हर कुंजी पर प्रति सेकंड 20 अनुरोधों तक सीमित हैं। ज़्यादा चाहिए तो हमसे कहें।