This endpoint allows you to submit an email for validation and immediately returns a 202 response with a requestId. The validation result will be sent to your configured webhook endpoint once processing is complete. This is recommended for bulk validations or when you don't need immediate results.

Webhook Configuration

Your webhook endpoint must be configured prior to making the first request - this is something your success manager will help you set up during onboarding. The validation result will be sent as a POST request to your webhook URL.

Webhook Payload

The webhook will receive a POST request with the validation result. See the WebhookPayload schema for the complete structure.

Example payload:

{
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "email": "[email protected]",
  "allegrowStatus": "safe",
  "result": {
    "status": "safe",
    "subStatus": "primary"
  },
  "metadata": {
    "unmodifiedPayload": "that you submitted on your initial call"
  }
}

Note: allegrowStatus is deprecated and mirrors the value of result.status. It will continue to be returned for backward compatibility but will be removed in a future release — please migrate to reading result.status.