> ## 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.

# List Batches

> List your team batch jobs.

List your team's batch jobs. Pagination via `limit` and `skip` query parameters.

## Request

<ParamField query="limit" type="number" default="50">
  Max number of results
</ParamField>

<ParamField query="skip" type="number" default="0">
  Number of results to skip (offset)
</ParamField>

## Response

Returns an array of batch objects with `_id`, `status`, `totalCount`, `processedCount`, `createdAt`.

<RequestExample>
  ```bash Request theme={null}
  curl -X GET "https://api.bouncedetector.com/api/v1/batches?limit=10&skip=0" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  [
    {
      "_id": "507f1f77bcf86cd799439011",
      "status": "completed",
      "totalCount": 10,
      "processedCount": 10,
      "createdAt": "2025-03-09T14:30:00.000Z"
    },
    {
      "_id": "507f1f77bcf86cd799439012",
      "status": "processing",
      "totalCount": 100,
      "processedCount": 45,
      "createdAt": "2025-03-09T14:25:00.000Z"
    }
  ]
  ```
</ResponseExample>


## OpenAPI

````yaml GET /api/v1/batches
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:
    get:
      tags:
        - Batch
      summary: List batch jobs
      description: List your team's batch jobs. Pagination via `limit` and `skip`.
      operationId: listBatches
      parameters:
        - name: limit
          in: query
          schema:
            type: integer
            default: 50
          example: 10
        - name: skip
          in: query
          schema:
            type: integer
            default: 0
          example: 0
      responses:
        '200':
          description: List of batches
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Batch'
              example:
                - _id: 507f1f77bcf86cd799439011
                  status: completed
                  totalCount: 10
                  processedCount: 10
                  createdAt: '2025-03-09T14:30:00.000Z'
                - _id: 507f1f77bcf86cd799439012
                  status: processing
                  totalCount: 100
                  processedCount: 45
                  createdAt: '2025-03-09T14:25:00.000Z'
        '401':
          $ref: '#/components/responses/Unauthorized'
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
    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.

````