# Batch Scrape Completed

> Webhook event sent when all URLs in a batch scrape have been processed.

`webhook batchScrapeCompleted`

For payload examples, configuration, and retry behavior, see [Webhook Event Types](/webhooks/events#batch_scrapecompleted) and [Webhook Overview](/webhooks/overview).

## OpenAPI

````yaml api-reference/webhooks-openapi.json webhook batchScrapeCompleted
openapi: 3.1.0
info:
  title: Firecrawl Webhooks
  version: v2
webhooks:
  batchScrapeCompleted:
    post:
      summary: Batch Scrape Completed
      operationId: batchScrapeCompleted
      tags:
        - Batch Scrape
      parameters:
        - $ref: "#/components/parameters/FirecrawlSignature"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - success
                - type
                - id
                - webhookId
                - data
              properties:
                success:
                  type: boolean
                  const: true
                type:
                  type: string
                  const: batch_scrape.completed
                id:
                  type: string
                  format: uuid
                  description: The batch scrape job ID.
                webhookId:
                  type: string
                  format: uuid
                  description: Unique identifier for this webhook delivery.
                data:
                  type: array
                  items: {}
                  description: Empty array. Retrieve results via `GET /batch/scrape/{id}`.
                  default: []
                metadata:
                  $ref: "#/components/schemas/WebhookMetadata"
            example:
              success: true
              type: batch_scrape.completed
              id: 550e8400-e29b-41d4-a716-446655440000
              webhookId: b2c3d4e5-0003-0000-0000-000000000000
              data: []
              metadata: {}
      responses:
        "200":
          description: Return any `2xx` status code to acknowledge receipt.
components:
  parameters:
    FirecrawlSignature:
      name: X-Firecrawl-Signature
      in: header
      required: false
      description: HMAC-SHA256 signature of the raw request body, formatted as
        `sha256=<hex>`. Present when an HMAC secret is configured in your
        [account settings](https://www.firecrawl.dev/app/settings?tab=advanced).
        See [Webhook Security](/webhooks/security) for verification details.
      schema:
        type: string
        example: sha256=abc123def456789...
  schemas:
    WebhookMetadata:
      type: object
      description: The custom metadata object you provided in the webhook
        configuration. Echoed back in every delivery.
      additionalProperties:
        type: string
````