Skip to main content
Submit Email Batch
curl --request POST \
  --url https://api.sandbox.verisoul.ai/email \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "emails": [
    {
      "email": "john.doe@example.com",
      "claims": {
        "name": {
          "first": "John",
          "last": "Doe"
        },
        "country": "US"
      }
    },
    {
      "email": "jane.doe@example.com",
      "claims": {
        "name": {
          "first": "Jane",
          "last": "Doe"
        },
        "phone": "+14155551234"
      }
    },
    {
      "email": "unknown@example.com"
    }
  ],
  "batch_name": "onboarding-review-2026-03",
  "identity_intelligence": true
}
'
{
  "batch_id": "bbc73b22-bd47-48e4-b173-c9ca085efb2a",
  "batch_name": "onboarding-review-2026-03",
  "status": "pending",
  "total_count": 3,
  "webhook_configured": true
}
This endpoint accepts a batch for processing and returns a batch_id for correlation. Each email’s full analysis result is delivered asynchronously through the email.intelligence.completed webhook. See the Webhook Payload Reference for response fields and examples.

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
emails
object[]
required

Array of Email Objects to analyze

​
batch_name
string

Optional name for the batch. If not provided, one is auto-generated.

​
identity_intelligence
boolean

Enable deeper identity analysis for all emails in the batch. See Identity Intelligence.

Response

Batch accepted for processing

​
batch_id
string

Unique identifier for this batch

​
batch_name
string

Name of the batch (provided or auto-generated)

​
status
string

Always pending on creation

​
total_count
integer

Number of emails in the batch

​
webhook_configured
boolean

Whether the project has an active webhook subscription for email intelligence results. If false, results are still processed but no webhook will be delivered.