---
title: "Get bulk verification results"
method: GET
path: "/verify/v1/email/bulk/results/{requestId}"
tags: ["Email Verification"]
---

# Get bulk verification results

`GET /verify/v1/email/bulk/results/{requestId}`

## Request

- Base URL: `https://api.customeros.ai`
- URL: `https://api.customeros.ai/verify/v1/email/bulk/results/{requestId}`
- Auth: API key in header `X-CUSTOMER-OS-API-KEY`
- TypeScript: <https://skmtc.dev/customeros/apis/customeros-api/docs/verify/v1/email/bulk/results/:requestId/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves results or status of bulk verification job

## Path parameters

- `requestId` string, uuid, required

## Response `200`

Verification results or status

- RestverifyBulkResultsResponse: Response containing bulk verification results or status
  - `estimatedCompletionTs` integer: Estimated completion timestamp required: true
  - `fileName` string: Original filename required: true
  - `jobId` string: Unique job identifier required: true format: uuid
  - `message` string: Progress message required: true
  - `results` RestverifyBulkResultsDetails: Detailed statistics for bulk verification results
    - `deliverable` integer: Number of deliverable emails required: true minimum: 0
    - `downloadUrl` string: URL to download detailed results required: true format: uri
    - `totalEmails` integer: Total number of emails processed required: true minimum: 0
    - `undeliverable` integer: Number of undeliverable emails required: true minimum: 0
  - `status` string: Processing status required: true enum: processing,completed

## Other responses

- `400`: Invalid job ID
- `401`: Unauthorized - Missing or invalid API key
- `404`: Job not found
- `500`: Internal server error

## Changes

- **2026-07-17** `73526747b270`: 3 info
  - api tag `Email Verification` added
  - api tag `Verify API` removed
  - added the non-success response with the status `404`
- **2024-09-10** `32a769da53f1`: 1 info
  - endpoint added
- **2024-09-10** `1ee4ed170cfa`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/customeros/apis/customeros-api/changes/verify/v1/email/bulk/results/:requestId/get.md)

---

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