---
title: "Batch Status"
method: GET
path: "/v1/batch/{batch_uuid}"
tags: ["Batch"]
---

# Batch Status

`GET /v1/batch/{batch_uuid}`

## Request

- Base URL: `https://api.apexverify.com`
- URL: `https://api.apexverify.com/v1/batch/{batch_uuid}`
- Auth: API key in header `X-API-Key`

Retrieve the current status of the batch. Once available, the response also includes execution costs, results, and refund information.

## Path parameters

- `batch_uuid` string, uuid, required

## Response `200`

Successful Response

- union
  - ParsingContentBatchStatusModel
    - `status` 'parsing_content', required
  - ReadyForVerificationBatchStatusModel
    - `status` 'ready_for_verification', required
    - `found_content` union, required
      - BatchSetupVerificationParsingEmail
        - `valid_email` integer
        - `wrong_email` integer
        - `duplicate_email` integer
      - BatchSetupVerificationParsingPhone
        - `valid_phone` integer
        - `wrong_phone` integer
        - `duplicate_phone` integer
    - `found_cost` union, required
      - BatchSetupVerificationCostEmail
        - `total_email_cost` integer, required
        - `net_email_cost` number, required
        - `email_cache_account_return` integer, required
        - `email_cache_global_return` integer, required
      - BatchSetupVerificationCostPhone
        - `total_phone_cost` integer, required
        - `net_phone_cost` number, required
        - `phone_cache_account_return` integer, required
        - `phone_cache_global_return` integer, required
  - VerificationOngoingBatchStatusModel
    - `status` 'verification_ongoing', required
    - `found_content` union, required
      - BatchSetupVerificationParsingEmail
        - `valid_email` integer
        - `wrong_email` integer
        - `duplicate_email` integer
      - BatchSetupVerificationParsingPhone
        - `valid_phone` integer
        - `wrong_phone` integer
        - `duplicate_phone` integer
    - `found_cost` union, required
      - BatchSetupVerificationCostEmail
        - `total_email_cost` integer, required
        - `net_email_cost` number, required
        - `email_cache_account_return` integer, required
        - `email_cache_global_return` integer, required
      - BatchSetupVerificationCostPhone
        - `total_phone_cost` integer, required
        - `net_phone_cost` number, required
        - `phone_cache_account_return` integer, required
        - `phone_cache_global_return` integer, required
  - VerificationDoneBatchStatusModel
    - `status` 'verification_done', required
    - `found_content` union, required
      - BatchSetupVerificationParsingEmail
        - `valid_email` integer
        - `wrong_email` integer
        - `duplicate_email` integer
      - BatchSetupVerificationParsingPhone
        - `valid_phone` integer
        - `wrong_phone` integer
        - `duplicate_phone` integer
    - `found_cost` union, required
      - BatchSetupVerificationCostEmail
        - `total_email_cost` integer, required
        - `net_email_cost` number, required
        - `email_cache_account_return` integer, required
        - `email_cache_global_return` integer, required
      - BatchSetupVerificationCostPhone
        - `total_phone_cost` integer, required
        - `net_phone_cost` number, required
        - `phone_cache_account_return` integer, required
        - `phone_cache_global_return` integer, required
    - `stats` VerificationStats, required
      - `total_verification` integer, nullable
      - `total_verification_valid` integer, nullable
      - `total_verification_wrong` integer, nullable
      - `total_verification_unknown` integer, nullable
      - `total_verification_duplicate` integer, nullable
      - `total_verification_account_cache` integer, nullable
      - `total_verification_global_cache` integer, nullable
      - `total_verification_valid_perc` number, nullable
      - `total_verification_wrong_perc` number, nullable
      - `total_verification_unknown_perc` number, nullable
      - `total_verification_account_cache_perc` number, nullable
      - `total_verification_global_cache_perc` number, nullable
  - InternalErrorBatchStatusModel
    - `status` 'internal_error', required
    - `message` string, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Validation Error
- `429`: Too Many Requests
- `500`: Internal Server Error

---

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