> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bouncedetector.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Batch Results

> Get batch details and verification results.

Get batch details and verification results for each email. Replace `{id}` with the batch ID returned from [Create Batch](/api-reference/endpoint/batch-create).

## Request

<ParamField path="id" type="string" required>
  Batch ID from POST /api/v1/verify/batch
</ParamField>

## Response

<ResponseField name="batch" type="object">
  Batch metadata (status, totalCount, processedCount, createdAt)
</ResponseField>

<ResponseField name="emails" type="array">
  List of email verification results with `id`, `email`, `status`, `result`, `error`
</ResponseField>

<RequestExample>
  ```bash Request theme={null}
  curl -X GET "https://api.bouncedetector.com/api/v1/batches/507f1f77bcf86cd799439011" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "batch": {
      "_id": "507f1f77bcf86cd799439011",
      "status": "completed",
      "totalCount": 2,
      "processedCount": 2,
      "createdAt": "2025-03-09T14:30:00.000Z"
    },
    "emails": [
      {
        "id": "507f1f77bcf86cd799439013",
        "email": "user@example.com",
        "status": "verified",
        "result": {
          "email": "user@example.com",
          "valid": true,
          "deliverable": true,
          "acceptAll": false,
          "role": false,
          "temporary": false,
          "mx": true,
          "smtp": true,
          "score": 100
        },
        "error": null
      }
    ]
  }
  ```
</ResponseExample>


## OpenAPI

````yaml GET /api/v1/batches/{id}
openapi: 3.1.0
info:
  title: BounceDetector API
  description: >-
    Email verification API. All endpoints require API key authentication via
    Bearer token.
  version: 1.0.0
servers:
  - url: https://api.bouncedetector.com
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Verification
    description: Single and bulk email verification
  - name: Batch
    description: Batch job management
paths:
  /api/v1/batches/{id}:
    get:
      tags:
        - Batch
      summary: Get batch results
      description: Get batch details and verification results for each email.
      operationId: getBatch
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Batch with results
          content:
            application/json:
              schema:
                type: object
                properties:
                  batch:
                    $ref: '#/components/schemas/Batch'
                  emails:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        email:
                          type: string
                        status:
                          type: string
                        result:
                          $ref: '#/components/schemas/VerificationResult'
                        error:
                          type: string
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          description: Batch not found
components:
  schemas:
    Batch:
      type: object
      properties:
        id:
          type: string
        status:
          type: string
          enum:
            - pending
            - processing
            - completed
            - failed
            - cancelled
        totalCount:
          type: integer
        processedCount:
          type: integer
        createdAt:
          type: string
          format: date-time
    VerificationResult:
      type: object
      properties:
        email:
          type: string
        valid:
          type: boolean
        deliverable:
          type: boolean
        acceptAll:
          type: boolean
        role:
          type: boolean
        temporary:
          type: boolean
        mx:
          type: boolean
        smtp:
          type: boolean
        score:
          type: number
    Error:
      type: object
      properties:
        statusCode:
          type: integer
        message:
          type: string
  responses:
    Unauthorized:
      description: Missing or invalid API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: Your API key (e.g. bdt_abc123...). Obtain from the dashboard.

````