---
title: "List webhook deliveries for a batch"
method: GET
path: "/v1/web/batch/{id}/deliveries"
tags: ["Crawl & batch"]
---

# List webhook deliveries for a batch

`GET /v1/web/batch/{id}/deliveries`

## Request

- Base URL: `https://api.hydrafetch.com`
- URL: `https://api.hydrafetch.com/v1/web/batch/{id}/deliveries`
- Auth: API key in header `X-API-Key`

Every webhook callback we've attempted for this batch, with its status, attempt count, and last response — so you can see whether and why a delivery failed.

## Path parameters

- `id` string, required

## Response `200`

- WebhookDeliveriesResponseDto
  - `deliveries` WebhookDeliveryDto[], required
    - `id` string, required
    - `event` string, required: The event this delivery carried.
    - `status` 'pending' | 'success' | 'failed', required: pending while retries remain, success once delivered, failed once given up.
    - `attempts` number, required: How many delivery attempts have been made.
    - `responseStatus` object, nullable, required: HTTP status your endpoint returned on the last attempt.
    - `error` object, nullable, required: Why the last attempt failed, if it did.
    - `deliveredAt` object, nullable, required: When the delivery succeeded (ISO 8601).
    - `createdAt` string, required: When the delivery was first created (ISO 8601).

## Other responses

- `400`: The request body or query failed validation.
- `401`: The X-API-Key header is missing, malformed, or names a key that no longer exists.
- `402`: The workspace has no credits left for this request. Nothing was charged and nothing was fetched.
- `403`: The key is valid but the workspace may not make this request.
- `404`: No such job, or the id belongs to another workspace.
- `422`: The target site did not respond, or we could not read that page. This is a fact about that URL rather than a fault on our side, and retrying it will not change the answer. When details.retryAfterSeconds is present, asking again before then returns this same answer. Nothing was charged.
- `429`: The workspace exceeded its per-minute request limit. Read the RateLimit headers, or Retry-After on this response, and retry after the window resets.
- `500`: Unexpected server error. Nothing was charged.
- `503`: A dependency needed for the requested formats is unavailable. Safe to retry.

---

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