Skip to content
Kirim.Email SMTP API

Validate multiple email addresses

POST
/api/email/validate/bulk

Batch email validation with comprehensive checks. Optimized with caching - only uncached emails are processed. Maximum 100 emails per batch.

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
object
emails
required

Array of email addresses to validate (max 100)

Array<string>
<= 100 items
Example
{
  "emails": [
    "[email protected]",
    "[email protected]",
    "invalid-email"
  ]
}

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Batch email validation completed successfully

object
success
boolean
Example
true
data

Batch email validation results with summary

object
results

Array of individual validation results

Array<object>

Email validation result with comprehensive checks

object
email

The validated email address

string
Example
[email protected]
is_valid

Whether the email passed all validation checks

boolean
Example
true
error

Error message if validation failed

string
nullable
warnings

Array of validation warnings

Array<string>
Example
[]
cached

Whether result was served from cache

boolean
validated_at

ISO timestamp of validation

string
Example
2024-01-01T12:00:00Z
is_spamtrap

Whether email is identified as likely spamtrap

boolean
spamtrap_score

Spamtrap probability score (0.0-1.0)

number format: float
<= 1
Example
0.1
summary
object
total

Total number of emails validated

integer
Example
10
valid

Number of valid emails

integer
Example
7
invalid

Number of invalid emails

integer
Example
3
cached

Number of results served from cache

integer
Example
4
validated

Number of emails freshly validated

integer
Example
6

400

Section titled “400 ”

Invalid request parameters

object
success
boolean
message
string
Example
The given data was invalid.
errors
object

401

Section titled “401 ”

Unauthorized - Invalid or missing authentication

object
success
boolean
message
string
Example
Unauthorized

429

Section titled “429 ”

Rate limit exceeded

object
success
boolean
message
string
Example
Rate limit exceeded. Please try again later.
retry_after

Seconds until rate limit resets

integer
Example
3600

Headers

Section titled “Headers ”
Retry-After
integer

Seconds until rate limit resets

X-RateLimit-Limit
integer

Maximum requests per hour

X-RateLimit-Remaining
integer

Remaining requests in current window

500

Section titled “500 ”

Internal server error

object
success
boolean
message
string
Example
Internal server error occurred during email validation