BounceMint

API Documentation

Integrate our email validation service into your applications with our RESTful API. Get started with these endpoints and validate emails at scale.

Base URL

https://api.bouncemint.com

Authentication

All API requests require authentication using your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY
GET
/api/v1/balance

Get Balance and Usage

Retrieve your current account balance and API usage statistics

Headers

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Response

{
  "balance": 1000,
  "usage": {
    "emails_validated": 2500,
    "files_processed": 15,
    "current_month_usage": 850
  },
  "plan": "Professional"
}
POST
/api/v1/upload

Upload File (Create Order)

Upload a CSV or TXT file containing email addresses for bulk validation

Headers

Authorization: Bearer YOUR_API_KEY
Content-Type: multipart/form-data

Request Body

{
  "file": "emails.csv (multipart file)",
  "webhook_url": "https://your-webhook.com/callback (optional)"
}

Response

{
  "order_id": "ord_abc123",
  "status": "processing",
  "file_name": "emails.csv",
  "total_emails": 1000,
  "estimated_completion": "2024-01-15T10:30:00Z"
}
GET
/api/v1/order/:order_id

Get Order Status

Check the status of your bulk validation order and download results

Headers

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Response

{
  "order_id": "ord_abc123",
  "status": "completed",
  "progress": 100,
  "total_emails": 1000,
  "valid_emails": 850,
  "invalid_emails": 150,
  "download_url": "https://api.bouncemint.com/download/ord_abc123",
  "expires_at": "2024-01-22T10:30:00Z"
}
POST
/api/v1/validate

Single Email Validation

Validate a single email address in real-time

Headers

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Request Body

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

Response

{
  "email": "user@example.com",
  "valid": true,
  "reason": "valid",
  "disposable": false,
  "role_based": false,
  "free_provider": false,
  "mx_record": true,
  "smtp_check": true
}

Rate Limiting

API requests are rate limited based on your plan:

  • Starter: 100 requests per minute
  • Professional: 1,000 requests per minute
  • Enterprise: Custom limits

Error Codes

400 - Bad Request
401 - Unauthorized
429 - Rate Limited
500 - Internal Server Error