Skip to content
Kirim.Email SMTP API

Validate multiple email addresses

POST
/api/email/validate/bulk
curl --request POST \
  --url https://smtp-app.kirim.email/api/email/validate/bulk \
  --header 'Authorization: Basic <credentials>' \
  --header 'Content-Type: application/json' \
  --data '{ "emails": { "emails": [ "[email protected]", "[email protected]", "invalid-email" ] } }'

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

Authorizations

Section titled “Authorizations”

Request Bodyrequired

Section titled “Request Bodyrequired”
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

Media typeapplication/json
object
success
boolean
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
is_valid

Whether the email passed all validation checks

boolean
error

Error message if validation failed

string
nullable
warnings

Array of validation warnings

Array<string>
cached

Whether result was served from cache

boolean
validated_at

ISO timestamp of validation

string
is_spamtrap

Whether email is identified as likely spamtrap

boolean
spamtrap_score

Spamtrap probability score (0.0-1.0)

number format: float
<= 1
summary
object
total

Total number of emails validated

integer
valid

Number of valid emails

integer
invalid

Number of invalid emails

integer
cached

Number of results served from cache

integer
validated

Number of emails freshly validated

integer
Example
{
  "success": true,
  "data": {
    "results": [
      {
        "email": "[email protected]",
        "is_valid": true,
        "error": null,
        "warnings": [],
        "cached": false,
        "validated_at": "2024-01-01T12:00:00Z",
        "is_spamtrap": false,
        "spamtrap_score": 0.1
      }
    ],
    "summary": {
      "total": 10,
      "valid": 7,
      "invalid": 3,
      "cached": 4,
      "validated": 6
    }
  }
}

400

Section titled “400”

Invalid request parameters

Media typeapplication/json
object
success
boolean
message
string
errors
object
Example
{
  "success": false,
  "message": "The given data was invalid."
}

401

Section titled “401”

Unauthorized - Invalid or missing authentication

Media typeapplication/json
object
success
boolean
message
string
Example
{
  "success": false,
  "message": "Unauthorized"
}

429

Section titled “429”

Rate limit exceeded

Media typeapplication/json
object
success
boolean
message
string
retry_after

Seconds until rate limit resets

integer
Example
{
  "success": false,
  "message": "Rate limit exceeded. Please try again later.",
  "retry_after": 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

Media typeapplication/json
object
success
boolean
message
string
Example
{
  "success": false,
  "message": "Internal server error occurred during email validation"
}