---
title: "Retrieve bulk verification results"
method: GET
path: "/v1/bulk/{job_id}/results"
---

# Retrieve bulk verification results

`GET /v1/bulk/{job_id}/results`

## Request

- Base URL: `https://api.reacher.email`
- URL: `https://api.reacher.email/v1/bulk/{job_id}/results`
- Auth: API key in header `Authorization`

Retrieve the results of a bulk verification job. This endpoint will return an error if the job is still running. Please query `GET /v1/bulk/{job_id}` first to check the job's progress.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

OK

- object
  - `results` CheckEmailOutput, required: The result of the email verification process.
    - `input` string, email, required: The email address that was verified.
    - `is_reachable` 'invalid' | 'unknown' | 'safe' | 'risky', required: An enumeration describing the confidence level that the recipient address is valid: `safe`, `risky`, `invalid`, or `unknown`. Refer to our FAQ for detailed definitions: https://help.reacher.email/email-attributes-inside-json.
    - `misc` union, required: Additional information about the email account.
      - MiscDetails: Additional information about the email account.
        - `is_disposable` boolean, required: Indicates if the email address is from a known disposable email provider.
        - `is_role_account` boolean, required: Indicates if the email address is a role-based account.
        - `gravatar_url` string: URL to the Gravatar profile picture associated with the email, if available and requested.
        - `is_b2c` boolean, required: Is this a B2C email address?
      - CoreError: Details of an error encountered during the verification process.
        - `type` string, required: The type of error.
        - `message` string, required: A human-readable description of the error.
    - `mx` union, required: Details obtained from querying the mail server's MX records.
      - MxDetails: Details about the mail server's MX records.
        - `accepts_mail` boolean, required: Indicates if the mail server accepts emails. False if there are no MX records, the domain publishes a null MX (RFC 7505), or none of the MX hosts resolve.
        - `records` string[], required: List of Fully Qualified Domain Names (FQDN) of the mail server.
      - CoreError: Details of an error encountered during the verification process.
        - `type` string, required: The type of error.
        - `message` string, required: A human-readable description of the error.
    - `smtp` union, required: Results from connecting to the mail server via SMTP.
      - SmtpDetails: Results from SMTP connection attempts to the mail server.
        - `can_connect_smtp` boolean, required: Indicates if the mail exchanger can be contacted successfully.
        - `has_full_inbox` boolean, required: Indicates if the mailbox is full.
        - `is_catch_all` boolean, required: Indicates if the email address is a catch-all address.
        - `is_deliverable` boolean, required: Indicates if an email sent to this address is deliverable.
        - `is_disabled` boolean, required: Indicates if the email address has been disabled by the provider.
      - CoreError: Details of an error encountered during the verification process.
        - `type` string, required: The type of error.
        - `message` string, required: A human-readable description of the error.
    - `syntax` SyntaxDetails, required: Validation of the email address syntax.
      - `domain` string, required: The domain part of the email address.
      - `is_valid_syntax` boolean, required: Indicates if the email address syntax is valid.
      - `username` string, required: The username part of the email address.
    - `debug` DebugDetails
      - `start_time` string, required: The timestamp when the email verification started.
      - `end_time` string, required: The timestamp when the email verification ended.
      - `duration` Duration, required: An object representing a duration in seconds and nanoseconds.
        - `secs` number, required: Duration in seconds.
        - `nanos` number, required: Duration in nanoseconds.
      - `server_name` string, required: The name of the server that performed the verification.
      - `reacher_version` string: The version of Reacher that performed the verification, e.g. "0.11.10".
      - `smtp` DebugDetailsSmtp, required: SMTP details used for debugging, including the verification method.
        - `verif_method` VerifMethod: The method used for email verification.
          - `type` 'Smtp' | 'Headless' | 'Api' | 'Skipped', required: The method used for the email verification.

## Changes

- **2026-10-13** `3f951831f616`: 1 info
  - added the optional property `results/debug/reacher_version` to the response with the `200` status
- **2024-12-30** `0ae4aa730c0a`: 1 breaking, 2 info
  - removed the required property `results/debug/backend_name` from the response with the `200` status
  - added the required property `results/debug/server_name` to the response with the `200` status
  - added the required property `results/misc/oneOf[subschema #1: MiscDetails]/is_b2c` to the response with the `200` status
- **2024-12-14** `bbc3d8433771`: 1 breaking, 1 info
  - removed the required property `results/debug/server_name` from the response with the `200` status
  - added the required property `results/debug/backend_name` to the response with the `200` status
- **2024-11-25** `e205c9ae16c8`: 1 info
  - endpoint added
- **2022-08-15** `f6c5a050fb0f`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/reacherhq/apis/reacher/changes/v1/bulk/:job_id/results/get.md)

---

[API](https://skmtc.dev/reacherhq/apis/reacher.md) - [All operations](https://skmtc.dev/reacherhq/apis/reacher/llms.txt) - [OpenAPI document](https://skmtc.dev/reacherhq/apis/reacher/revisions/e829a8a612e2?raw)