Board Watches

List delivery history for a watch

Changed on Nov 7, 2026

The most recent webhook delivery attempts for a watch you own, newest first. Only webhook/both channel watches have delivery history; an email-only watch always returns an empty list here (email sends are not logged per-attempt). Test deliveries (POST /watches/{id}/test) never appear, as they are not persisted.

consecutiveFailures counts how many of the most recent attempts failed in a row, and deliveryHealth is failing once that reaches 3. Read them before reading the list: a watch can keep firing on schedule and delivering nothing, and the streak is the only field that distinguishes that from a bad day. consecutiveFailuresTruncated is true when the streak fills the whole page, meaning the real run is at least this long. deliveryHealth is blocked when the newest attempt was not sent because the account's plan no longer includes webhook delivery (Business); the row's error says so. Page back with beforeId = meta.nextBeforeId.

Nothing notifies you when a webhook starts failing, so poll this route. We alert ourselves after 3 consecutive failures, but we send you no email and no callback, and a failing receiver is in your infrastructure rather than ours. A watch stays active and keeps being dispatched while every delivery fails, so silence from your endpoint is not evidence that the law did not change. Check deliveryHealth on a schedule of your own.

error on each attempt says why it failed, including the redirect target when an endpoint answered 3xx. Deliveries do not follow redirects: a 3xx is a failed delivery, not a delivered one, so register the endpoint's final URL.

Free.

get/api/v1/watches/{watch_id}/deliveries

Request

Base URL
https://api.vaquill.ai
Auth
- HTTP bearer
- or API key in header X-API-Key
TypeScript
https://skmtc.dev/vaquill/apis/vaquill-developer-api/docs/api/v1/watches/:watch_id/deliveries/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

watch_idstring required

Id of the watch, as returned by POST /watches (id).

Query parameters

limitinteger

Max deliveries to return.

beforeIdinteger nullable

Return only attempts with an id less than this: page back past limit by passing meta.nextBeforeId (the smallest id on your last page). Same cursor contract as /changes.

Response

The watch's delivery history, newest first.

Changes

Nov 7, 2026340c0d24d0b6 Revision changes
- warning
  added the new blocked enum value to the / response property for the response status
- info
  added the new optional query request parameter beforeId
- info
  added the non-success response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property / to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status

Operation history