# List Webhook Deliveries

`GET https://api.getprospect.com/v2/webhooks/{id}/deliveries`

Delivery attempts of the last 30 days, newest first: event type, status, attempt number, the coarse outcome of the last attempt and when the next one is due. Free: no credits.

## Authentication

Pass your API key in the `x-api-key` header.

## Path parameters

- `id` (string, required): The webhook id (24 hex characters).

## Query parameters

- `page` (integer, optional, min: 1, max: 1000, default: 1): The page, 1-based.
- `per_page` (enum, optional, default: 25): Items per page. Allowed values: `25`, `50`, `100`.
- `status` (enum, optional): `pending` is waiting for an attempt or a retry; `succeeded` and `failed` are final. Allowed values: `succeeded`, `failed`, `pending`.

## Example request

```bash
curl --request GET \
  --url https://api.getprospect.com/v2/webhooks/{id}/deliveries \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Response 200

One page of deliveries.

```json
{
  "success": true,
  "data": [
    {
      "id": "evt_6704b1c2d3e4f5061728394a",
      "event_type": "person.saved",
      "status": "pending",
      "attempt": 2,
      "delivered": false,
      "status_class": "5xx",
      "error_code": null,
      "next_attempt_at": "2026-10-08T12:30:00.000Z",
      "created_at": "2026-10-08T11:54:00.000Z",
      "updated_at": "2026-10-08T12:00:00.000Z"
    }
  ],
  "metadata": {
    "timestamp": "2026-10-08T12:00:00.000Z",
    "pagination": {
      "page": 1,
      "per_page": 25,
      "total_pages": 1,
      "total_count": 1
    }
  }
}
```

## Response 400

Malformed id, or a query parameter out of range or unknown (`VALIDATION_ERROR`).

```json
{
  "success": false,
  "data": null,
  "metadata": {
    "timestamp": "2026-10-08T12:00:00.000Z"
  },
  "errors": [
    {
      "name": "VALIDATION_ERROR",
      "message": "per_page: 10 is not an accepted value. Accepted: 25, 50, 100",
      "payload": {
        "field": "per_page",
        "code": "value_not_allowed",
        "received_value": 10,
        "received_type": "number",
        "invalid_values": [
          10
        ],
        "allowed_values": [
          25,
          50,
          100
        ]
      }
    }
  ]
}
```

## Response 401

Missing, unknown or inactive credentials (`UNAUTHORIZED`).

## Response 404

No such webhook in this workspace (`NOT_FOUND`).

```json
{
  "success": false,
  "data": null,
  "metadata": {
    "timestamp": "2026-10-08T12:00:00.000Z"
  },
  "errors": [
    {
      "name": "NOT_FOUND",
      "message": "Webhook not found."
    }
  ]
}
```

## Response 500

Unexpected server error.