API xác minh email hoạt động ngay

Xác thực

Gửi khóa API dưới dạng bearer token trong header Authorization ở mọi yêu cầu. Giữ khóa trên máy chủ của bạn. Không bao giờ đặt khóa trong mã trình duyệt hoặc ứng dụng di động.

Authorization: Bearer YOUR_API_KEY

URL gốc cho mọi endpoint là https://bouncebell.com/api/v1.

Xác minh một địa chỉ

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

Ví dụ

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
}

Các trường kết quả

Các trạng thái

Batch

Gửi tối đa 100.000 địa chỉ trong một yêu cầu. Batch chạy trong nền; hãy kiểm tra trạng thái định kỳ hoặc cung cấp callback_url và chúng tôi sẽ gọi URL đó khi batch hoàn tất.

Tạo batch

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 }

Credit cho mỗi địa chỉ duy nhất được giữ lại khi tạo batch, và kết quả không xác định được hoàn lại khi batch hoàn tất. Callback nhận một yêu cầu POST với {"event": "batch.completed", "batch_id": "...", "status": "done", "counts": {...}}. URL callback phải dùng HTTPS.

Kiểm tra tiến độ

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

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

Trạng thái là queued, running hoặc done. Khi trạng thái là done, phản hồi cũng có counts theo từng trạng thái.

Tải xuống kết quả

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

Mặc định trả về JSON. Thêm ?format=csv để nhận tệp CSV. Mỗi dòng có các trường giống như một lượt kiểm tra đơn lẻ.

Credit

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

{ "credits_remaining": 33420 }

Lỗi và giới hạn

Lỗi trả về phần thân JSON với mã error và message dễ đọc.

Kiểm tra đơn lẻ được giới hạn 20 yêu cầu mỗi giây cho mỗi khóa. Hãy liên hệ nếu bạn cần nhiều hơn.