How to use the API

The BounceProtect API lets you validate emails directly from your application. Every API call costs 1 credit.

Authentication

All requests require a Bearer token in the Authorization header. Generate API keys from Dashboard → API Keys.

Single email validation

POST https://www.bounceprotect.com/api/v1/validate/email

{
  "email": "user@example.com"
}

Returns: status, status_reason, status_explanation, deliverability_score, spam_score, send_recommendation, and a full signals object.

Bulk validation (up to 100 emails)

POST https://www.bounceprotect.com/api/v1/validate/bulk

{
  "emails": ["user1@example.com", "user2@example.com"]
}

Returns an array of results with the same fields, plus credits_used and credits_remaining.

Account balance

GET https://www.bounceprotect.com/api/v1/account/balance

Returns your current credit balance.

Rate limits by plan

Implement exponential backoff when you receive a 429 response.

The send_recommendation field

The fastest way to action results. Filter to SEND for your safest addresses, SEND_WITH_CAUTION for acceptable risk, and always suppress DO_NOT_SEND. The REVIEW bucket requires a manual decision.