Email Validation API - Onboarding Buddy

The Onboarding Buddy Email Validation API enables developers to validate email addresses with precision, ensuring accurate user data, checking for disposable domains, and verifying MX records. Perfect for onboarding, compliance, fraud prevention, and marketing campaigns, this API offers single and batch validation endpoints to streamline your application’s user verification process.

Key Features

• Single Email Validation: Instantly verify one email address for format, domain, and deliverability.
• Batch Validation: Process multiple email addresses in a single request for efficiency.
• Disposable Domain Detection: Identify temporary or disposable email providers to prevent fraudulent sign-ups.
• MX Record Verification: Confirm email deliverability by checking domain mail servers.
• Secure API Access: Use App Key, API Key, and API Secret for authenticated requests.

Relevant Endpoints

Endpoint	Method	Purpose
POST /validation-service/validation/email	POST	Validates a single email address and returns the validation response.
POST /validation-service/batch/email-address	POST	Validates a batch of email addresses and returns a batch validation response.
GET /validation-service/batch/poll/{batchId}	GET	Polls the status of a submitted batch validation request using the batch ID.
GET /validation-service/batch/email-address/{batchId}	GET	Retrieves the validation results for a batch of email addresses using the batch ID.

Code Samples

Validate a Single Email Address

Use the POST /validation-service/validation/email endpoint to validate a single email address. Include your API credentials in the headers for secure access.

curl -X POST https://www.onboardingbuddy.co/validation-service/validation/email \
-H "ob-app-key: your-app-key" \
-H "ob-api-key: your-api-key" \
-H "ob-api-secret: your-api-secret" \
-H "Content-Type: application/json" \
-d '{"email": "user@example.com"}'
    

Example Response:

{
  "isValid": true,
  "details": {
    "format": "valid",
    "domain": "example.com",
    "isDisposable": false,
    "mxRecords": ["mx.example.com"]
  }
}
    

Validate a Batch of Email Addresses

Use the POST /validation-service/batch/email-address endpoint to validate multiple email addresses efficiently.

curl -X POST https://www.onboardingbuddy.co/validation-service/batch/email-address \
-H "ob-app-key: your-app-key" \
-H "ob-api-key: your-api-key" \
-H "ob-api-secret: your-api-secret" \
-H "Content-Type: application/json" \
-d '{"emails": ["user1@example.com", "user2@disposable.com", "invalid.email"]}'
    

Example Response:

{
  "batchId": "batch-12345",
  "status": "processing"
}
    

Poll Batch Validation Status

Check the status of a batch validation request using the GET /validation-service/batch/poll/{batchId} endpoint.

curl -X GET https://www.onboardingbuddy.co/validation-service/batch/poll/batch-12345 \
-H "ob-app-key: your-app-key" \
-H "ob-api-key: your-api-key" \
-H "ob-api-secret: your-api-secret"
    

Example Response:

{
  "batchId": "batch-12345",
  "status": "completed"
}
    

Retrieve Batch Validation Results

Retrieve the results of a completed batch validation using the GET /validation-service/batch/email-address/{batchId} endpoint.

curl -X GET https://www.onboardingbuddy.co/validation-service/batch/email-address/batch-12345 \
-H "ob-app-key: your-app-key" \
-H "ob-api-key: your-api-key" \
-H "ob-api-secret: your-api-secret"
    

Example Response:

{
  "batchId": "batch-12345",
  "results": [
    {
      "email": "user1@example.com",
      "isValid": true,
      "details": {
        "format": "valid",
        "domain": "example.com",
        "isDisposable": false,
        "mxRecords": ["mx.example.com"]
      }
    },
    {
      "email": "user2@disposable.com",
      "isValid": false,
      "details": {
        "format": "valid",
        "domain": "disposable.com",
        "isDisposable": true
      }
    },
    {
      "email": "invalid.email",
      "isValid": false,
      "details": {
        "format": "invalid"
      }
    }
  ]
}
    

Applications of Email Validation

The Onboarding Buddy Email Validation API is ideal for:

• User Onboarding: Ensure valid email addresses during registration to improve user data quality.
• Email Marketing: Reduce bounce rates by verifying email lists before campaigns.
• Fraud Prevention: Block disposable email addresses to prevent fraudulent sign-ups.
• KYC Compliance: Validate email addresses as part of identity verification processes.

Next Steps

Get started with the Onboarding Buddy Email Validation API today. Sign up to obtain your API credentials, explore the full API documentation, or discover other use cases like mobile validation or sanctions checks. For technical details, view all API endpoints.

Start Validating Emails Now