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

> List your team verification history.

List recent verifications for your team. Pagination via `limit` and `skip` query parameters.

## Request

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

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

## Response

Returns an array of verification results (same structure as Verify Email).

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

<ResponseExample>
  ```json Response theme={null}
  [
    {
      "email": "user@example.com",
      "valid": true,
      "deliverable": true,
      "acceptAll": false,
      "role": false,
      "temporary": false,
      "mx": true,
      "smtp": true,
      "score": 100
    },
    {
      "email": "info@company.com",
      "valid": true,
      "deliverable": true,
      "acceptAll": false,
      "role": true,
      "temporary": false,
      "mx": true,
      "smtp": true,
      "score": 85
    }
  ]
  ```
</ResponseExample>


## OpenAPI

````yaml GET /api/v1/verifications
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/verifications:
    get:
      tags:
        - Verification
      summary: List verification history
      description: >-
        List recent verifications for your team. Pagination via `limit` and
        `skip`.
      operationId: listVerifications
      parameters:
        - name: limit
          in: query
          schema:
            type: integer
            default: 100
          example: 10
        - name: skip
          in: query
          schema:
            type: integer
            default: 0
          example: 0
      responses:
        '200':
          description: List of verifications
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/VerificationResult'
              example:
                - email: user@example.com
                  valid: true
                  deliverable: true
                  acceptAll: false
                  role: false
                  temporary: false
                  mx: true
                  smtp: true
                  score: 100
                - email: info@company.com
                  valid: true
                  deliverable: true
                  acceptAll: false
                  role: true
                  temporary: false
                  mx: true
                  smtp: true
                  score: 85
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    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.

````