---
title: "Get a batch email validation job"
method: GET
path: "/email_validations/batch/{id}"
tags: ["Email Validations"]
---

# Get a batch email validation job

`GET /email_validations/batch/{id}`

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/email_validations/batch/{id}`
- Auth: HTTP bearer

Retrieves the current status and, once completed, validation results for a batch job.

## Path parameters

- `id` string, uuid, required

## Response `200`

Batch validation job status.

- EmailValidationBatchDetailResponse
  - `data` EmailValidationBatchDetail, required: Shape returned by the GET endpoint. Does not include duplicates_removed.
    - `record_type` 'email_validation_batch', required
    - `id` string, uuid, required
    - `status` 'pending' | 'processing' | 'completed' | 'failed', required
    - `total` integer, required
    - `webhook_url` string, uri
    - `completed_at` string, date-time
    - `results` object: Map keyed by original email address. Present only when the batch is completed.

## Other responses

- `401`: Not authorized (10006).
- `404`: Resource not found (10001).

## Changes

- **2026-10-15** `a72569d69430`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/team-telnyx/apis/telnyx-api/changes/email_validations/batch/:id/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api.md) - [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api/llms.txt) - [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api/revisions/a73101b68823?raw)