Webhooks

List deliveries

GEThttps://api.vaakyo.com/api/v1/webhooks/deliveries

The delivery log, newest first. status takes several values separated by commas (pending, delivered, failed).

Authorization

An API key (X-API-Key or Authorization: Bearer), or a signed-in member with the keys.manage permission.

X-API-KeyAuthorization: Bearerkeys.manage

Query parameters

endpoint_idstring

an endpoint id, agent (agent URLs) or campaign (campaign URLs)

at most 64 characters

statusstring

pending, delivered, retrying, failed

at most 40 characters

call_idstring

Only this call's deliveries.

at most 64 characters

event_typestring

comma-separated event types

at most 200 characters

sincestring | null

created at or after this time (ISO 8601)

date-time

untilstring | null

created before this time (ISO 8601)

date-time

limitintegerdefault: 50

How many to return.

1 to 200

skipintegerdefault: 0

How many to skip (for paging).

at least 0

timezonestringdefault: "Asia/Kolkata"

IANA time zone for every timestamp in the response (at, date, timestamp and *_at fields), as ISO 8601 with the offset. The X-Timezone header works too; the zone used comes back in the X-Timezone response header. An unknown zone is a 400.

Response

200Success.

See the 200 example next to the code samples.

401No credentials, or they are invalid or revoked.

detailstring

What went wrong, in plain words.

403Your role (or an API key) lacks the permission.

detailstring

What went wrong, in plain words.

422Validation Error

detailobject[]

Show item attributes

locstring | integer[]

msgstring

typestring

429Over the per-key rate limit; wait for Retry-After.

detailstring

What went wrong, in plain words.

import requests url = "https://api.vaakyo.com/api/v1/webhooks/deliveries" params = { "timezone": "Asia/Kolkata", } headers = { "X-API-Key": "<api-key>", } response = requests.get(url, params=params, headers=headers) print(response.status_code, response.json())

const response = await fetch("https://api.vaakyo.com/api/v1/webhooks/deliveries?timezone=Asia/Kolkata", { headers: { "X-API-Key": "<api-key>", }, }) const data = await response.json() console.log(response.status, data)

{ "items": [ { "id": "whd_0b9e3f6c2d1a4e5f8a7b6c5d4e3f2a1b", "endpoint_id": "we_6f1d2c3b4a5e4f60a1b2c3d4e5f60718", "url": "https://example.com/vaakyo/events", "event_type": "call.completed", "event_id": "evt_5e4f3a2b1c0d4e5f6a7b8c9d0e1f2a3b", "call_id": "3f1c9a7e2b6d4c8e9f0a1b2c3d4e5f6a", "status": "delivered", "attempts": 1, "last_status_code": 200, "last_error": "", "created_at": "2026-09-30T15:45:02+05:30", "delivered_at": "2026-09-30T15:45:03+05:30", "next_attempt_at": null } ], "total": 1 }