---
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}`

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

> 78 revisions in range; 1 not diffed.

- **2026-09-22** `9621f6123ebc` — 4 warning
  - added the new `10011` enum value to the `errors/items/code` response property for the response status `401`
  - added the new `10011` enum value to the `errors/items/code` response property for the response status `404`
  - added the new `domain_graduation_limit_exceeded` enum value to the `errors/items/code` response property for the response status `401`
  - added the new `domain_graduation_limit_exceeded` enum value to the `errors/items/code` response property for the response status `404`
- **2026-07-16** `2fb3b617430a` — 4 warning, 2 info
  - added the new `recipient_suppressed` enum value to the `errors/items/code` response property for the response status `401`
  - added the new `recipient_suppressed` enum value to the `errors/items/code` response property for the response status `404`
  - added the new `reputation_suspended` enum value to the `errors/items/code` response property for the response status `401`
  - added the new `reputation_suspended` enum value to the `errors/items/code` response property for the response status `404`
  - …2 more
- …earlier changes not shown

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

---

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