§ 01 / API REFERENCE
Build with the BounceCheck API.
REST API. JSON over HTTPS. No SDK required. Verify single emails in real-time or process thousands via bulk upload — all from any language or framework.
§ 02 / AUTH
Authentication
All API requests require a Bearer token in the Authorization header. Generate and manage your keys from the API Keys dashboard.
Authorization: Bearer YOUR_API_KEY
API Key auth
Pass key via Authorization header on every request.
30-min access token
JWT tokens expire in 30 minutes — refresh automatically.
Rotate anytime
Create and revoke keys from the dashboard instantly.
§ 03 / ENDPOINT
Single Email Verify
Verify one email address in real-time. Returns result in 1–3 seconds.
/verification/singlecurl -X POST https://api.bouncecheck.email/api/v1/verification/single \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email": "[email protected]"}'Request body
{
"email": "[email protected]"
}Response
{
"email": "[email protected]",
"is_valid": true,
"status": "valid",
"message": "Address is deliverable"
}§ 04 / ENDPOINT
Bulk Upload
Upload a CSV or XLSX file (max 10 MB). The job runs async — poll /verification/status/:id every 2 s until completed.
/verification/bulkcurl -X POST https://api.bouncecheck.email/api/v1/verification/bulk \ -H "Authorization: Bearer YOUR_API_KEY" \ -F "[email protected]"
Upload response
{
"job_id": 42,
"message": "Job queued"
}Result item
{
"email": "[email protected]",
"is_valid": true,
"reason": null
}§ 05 / ENDPOINT
Job Status
Poll this endpoint after a bulk upload. Status transitions: pending → processing → completed or failed.
/verification/status/:idResponse
{
"id": 42,
"status": "processing",
"total_emails": 1000,
"processed_emails": 430,
"valid_emails": 390,
"invalid_emails": 40,
"created_at": "2025-04-13T10:00:00Z",
"completed_at": null
}§ 06 / MANAGEMENT
API Keys
Programmatically create and revoke keys. Useful for per-project key rotation.
| Method | Path | Description |
|---|---|---|
| POST | /verification/single | Verify a single email address |
| POST | /verification/bulk | Upload CSV/XLSX for batch verification |
| GET | /verification/status/:id | Poll job progress |
| GET | /verification/results/:id | Fetch job results when complete |
| GET | /verification/download/:id | Download CSV results |
| GET | /api-keys | List all API keys |
| POST | /api-keys | Create a new API key |
| DELETE | /api-keys/:id | Revoke an API key |
| GET | /stats/dashboard | Get usage statistics |
§ 07 / ERRORS
Error Codes
All errors return standard HTTP status codes with a JSON body: { "detail": "message" }
Bad Request
Missing or malformed request body.
Unauthorized
Invalid or missing API key.
Forbidden
Plan limit reached or key revoked.
Not Found
Job or resource does not exist.
Unprocessable
Validation error on request payload.
Rate Limited
Too many requests — back off and retry.
Server Error
Something went wrong on our side.
§ 08 / START BUILDING
Ready to integrate?
Create a free account, grab an API key, and make your first verification call in minutes.