A webhook endpoint's delivery log, newest first (admin)
const url = 'https://example.com/v1/orgs/example/webhooks/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/deliveries?limit=50';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://example.com/v1/orgs/example/webhooks/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/deliveries?limit=50' \ --header 'Authorization: Bearer <token>'One entry per event sent (or to be sent) to the endpoint, for the notification retention window (30 days by default). last_error is a fixed text such as “HTTP 503” or “no answer within 10 seconds”; it never contains the URL. next is the before= of the next page.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Organization (tenant) slug, e.g. alpenrobotik
Query Parameters
Section titled “Query Parameters”The next of the previous page
Responses
Section titled “Responses”A page
object
object
Evt_ and the event’s ID: the webhook-id header
A test event (POST …/test)
Pending: waiting for its first attempt or a retry; failed: 8 attempts, or 410 Gone; skipped: not sent, because the endpoint was off by then
The receiver’s last HTTP status; null without an answer
Why the last attempt failed, or why it was skipped; never the URL
When a pending delivery is tried (again)
Before= of the next page; null on the last
Example
{ "deliveries": [ { "event_type": "finding.new", "state": "pending" } ]}Request.invalid (params.field before or limit)
Auth.roleTooLow
No such object in this organization, no such organization, or the caller does not belong to it
Over the operation’s rate-limit budget (x-affectra-budget): code request.rateLimited with params.budget. Wait Retry-After seconds before trying again.
Every error answer, Content-Type
application/problem+json. The web app and integrations translate code; detail is English,
for people reading curl output or CI logs, and may change wording at
any time. Match on code, never on detail.
object
The HTTP status
Stable error codes. A code is never renamed; new ones may be added, so
a client falls back to detail for a code it doesn’t know. Another
organization’s object answers notFound, the same as a missing one.
What went wrong
Values the code’s message needs, e.g. {“field”: “version”}. Only values the caller sent or may see. Empty when the message needs none.
object
Example
{ "code": "notFound"}Headers
Section titled “Headers”Seconds until a request would be allowed again, at least 1
Notifications.unavailable