List webhook deliveries (tenant-wide)

GET

/webhook-deliveries

curl --request GET \
  --url 'https://app.buildworkpro.com/api/v1/webhook-deliveries?status=pending' \
  --header 'Authorization: Bearer <token>'

• Production

Returns cursor-paginated webhook delivery rows for the calling tenant across all endpoints. Filterable by endpoint, status, event type, and createdAt date range. Replaces the per-endpoint GET /webhook-endpoints/{id}/deliveries (still available but hard-capped at 100 rows with no pagination).

Authorizations

• bearerAuth
  webhooks:manage

Parameters

Query Parameters

limit

integer

>= 1 <= 100

cursor

string

endpointId

integer

>= 1

status

string

Allowed values: pending succeeded failed exhausted

eventType

string

dateFrom

string format: date-time

dateTo

string format: date-time

Responses

200

Deliveries page

Media type application/json

object

data

required

Array<object>

object

id

required

integer

eventId

required

string

endpointId

required

integer

status

required

string

Allowed values: pending succeeded failed exhausted

attemptCount

required

integer

nextAttemptAt

required

Any of:

string

string format: date-time

string

string

null

null

lastAttemptedAt

required

Any of:

string

string format: date-time

string

string

null

null

responseStatus

required

integer | null

responseBody

required

string | null

responseHeaders

required

object | null

errorMessage

required

string | null

createdAt

required

Any of:

string

string format: date-time

string

string

completedAt

required

Any of:

string

string format: date-time

string

string

null

null

meta

required

object

request_id

Server-generated request identifier

string

pagination

object

cursor

required

Opaque cursor for the next page; null when no more results

string | null

has_more

required

Whether more pages are available after this one

boolean

count

required

Items in this page

integer

Example

{
  "data": [
    {
      "status": "pending"
    }
  ]
}

400

Bad request

Media type application/problem+json

object

type

required

URL identifying the problem type

string format: uri

title

required

Short human-readable summary

string

status

required

HTTP status code

integer

detail

Human-readable explanation

string

request_id

Server-generated request identifier

string

errors

Validation error array (422 only)

Array<object>

object

field

required

Field path that failed validation

string

code

required

Validation error code

string

message

required

Human-readable validation message

string

Example ^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}

403

Scope insufficient

Media type application/problem+json

object

type

required

URL identifying the problem type

string format: uri

title

required

Short human-readable summary

string

status

required

HTTP status code

integer

detail

Human-readable explanation

string

request_id

Server-generated request identifier

string

errors

Validation error array (422 only)

Array<object>

object

field

required

Field path that failed validation

string

code

required

Validation error code

string

message

required

Human-readable validation message

string

Example ^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "request_id": "example",
  "errors": [
    {
      "field": "example",
      "code": "example",
      "message": "example"
    }
  ]
}