API

Verify at the point of capture

The BounceBlock API verifies an email and phone in one call — perfect for cleaning data as it enters your stack. Available on the Business plan.

Authentication

Authenticate with a Bearer token. Generate an API key from your dashboard on the Business plan.

Authorization: Bearer YOUR_API_KEY

Verify a contact

POST /v1/verify

Pass an email, a phone, or both.

curl https://api.bounceblock.io/v1/verify \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "amanda.cole@realty-group.com",
    "phone": "+1 (415) 555-0182"
  }'

Response

{
  "email": {
    "status": "valid",
    "sub_status": null,
    "did_you_mean": null
  },
  "phone": {
    "valid": true,
    "line_type": "mobile",
    "carrier": "Verizon"
  },
  "quality_score": 96
}

Status values

validMailbox exists and can receive email.
invalidDoesn't exist, wrong domain, or a typo — will bounce.
catch-allDomain accepts all mail; the specific mailbox can't be confirmed.
unknownThe mail server didn't give a clear answer.

Get an API keyAPI access is included on the Business plan.

See Business plan