---
title: "Gets the validation result of a batch of email."
method: GET
path: "/email/bulk/v1/batches/{batch_id}/results"
tags: ["Bulk Email"]
---

# Gets the validation result of a batch of email.

`GET /email/bulk/v1/batches/{batch_id}/results`

## Request

- Base URL: `https://api.experianaperture.io`
- URL: `https://api.experianaperture.io/email/bulk/v1/batches/{batch_id}/results`
- Auth: one of:
  - HTTP bearer
  - API key in header `Auth-Token`
- TypeScript: <https://skmtc.dev/experianaperture/apis/aperture-rest-api/docs/email/bulk/v1/batches/:batch_id/results/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `batch_id` string, required

## Headers

- `Reference-Id` string
- `Add-Metadata` boolean

## Response `200`

OK

- BulkEmailV1GetBatchResultsResponse: Bulk Email V1 Get Results response.
  - `error` ResponseError: Error model containing the error details.
    - `type` string, nullable: A link to documentation that provides more details about the error you’ve encountered.
    - `title` string, nullable: The title of the error.
    - `detail` string, nullable: A description of the error.
    - `instance` string, nullable: The endpoint that returned the error.
  - `result` BulkEmailV1GetBatchResultsResult: Bulk Email V1 Get Batch Results result.
    - `batch_id` string, nullable: Batch ID.
    - `batch_reference_id` string, nullable: Optional reference identifier to track this batch.
    - `credits_charged` integer: The number of credits charged for this Batch.
    - `status` string, nullable: The current Batch status.
    - `reason` string, nullable: The reason of the current Batch status.
    - `statistics` BulkEmailV1GetBatchResultsResponseStatistic[], nullable: The statistics of the email confidence level.
      - `name` string, nullable: Confidence.
      - `value` integer: Count.
    - `emails` BulkEmailV1GetBatchResultsResponseEmail[], nullable: The Emails validation results.
      - `email` string, nullable: The email address that is the subject of the validation.
      - `confidence` string, nullable: The outcome (confidence level) of the validation.
      - `verbose_output` string, nullable: Additional information on the confidence level.
      - `did_you_mean` string[], nullable: A list of more likely email addresses. Suggestions include fixes to syntax errors in the provided email address, typos in domains etc.
      - `metadata` BulkEmailV1GetBatchResultsResponseEmailMetadata: Metadata fields and values that can be returned, in addition to the main core information.
        - `domain_detail` BulkEmailV1GetBatchResultsResponseEmailMetadataDomainDetail: Details about the domain.
          - `type` string, nullable: Type field value: consumer - returned for "free" domains business - returned for "business" domains Omit the field "type" when we are unable to provide a value

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `406`: Not Acceptable
- `408`: Request Timeout
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/experianaperture/apis/aperture-rest-api.md) - [All operations](https://skmtc.dev/experianaperture/apis/aperture-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/experianaperture/apis/aperture-rest-api/revisions/e762934f3de5?raw)