---
title: "Submit Email Batch"
method: POST
path: "/email"
---

# Submit Email Batch

`POST /email`

Submit a batch of email addresses for asynchronous risk, deliverability, and identity analysis. [Results](/email-intelligence/webhook-reference) are delivered via webhook.

## Request body

- BatchEmailRequest
  - `emails` EmailEntry[], required — Array of [Email Objects](/api-reference/types/email) to analyze
    - `email` string, required — Email address to analyze
    - `claims` Claims — Identity claims to verify against data linked to the email. Useful when `identity_intelligence` is enabled.
      - `name` object — Expected name of the email owner. Provide first, last, or both.
        - `first` string — First name (e.g., "John")
        - `last` string — Last name (e.g., "Doe")
      - `phone` string — Phone number. E.164 format recommended (e.g., "+14155551234", "+442071234567").
      - `country` string — Two-letter ISO 3166-1 alpha-2 country code (e.g., "US", "GB", "CA").
    - `identity_intelligence` boolean — Enable deeper identity analysis for this email. Will override the `identity_intelligence` setting at the root level if set.
  - `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](/email-intelligence/identity-intelligence).

## Response `200`

Batch accepted for processing

- BatchEmailResponse
  - `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.

## Other responses

- `400` — Invalid request

---

[API](https://skmtc.net/verisoul/apis/verisoul-api.md) · [All operations](https://skmtc.net/verisoul/apis/verisoul-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/verisoul/verisoul-api/versions/a4f2fd0ee333/schema)