BioFlow / API docs / listWebhookDeliveries

List deliveries.

GET /v1/webhook-endpoints/{endpoint_id}/deliveries

scope: webhooks:readCreator & Pro plansquota cost: 1

The endpoint's delivery log, newest first, cursor-paginated, with per-attempt status codes, bounded error summaries, and the next automatic retry time.

Requires scope: webhooks:read. Plan entitlement: public_api (Creator and Pro).

Open in Claude ↗Open in ChatGPT ↗

Try it

Request.

curl "https://app.getbioflow.com/v1/webhook-endpoints/ENDPOINT_ID/deliveries" \
  -H "Authorization: Bearer bf_live_YOUR_KEY"

Parameters

Path & query parameters.

Parameters accepted by listWebhookDeliveries
Name	In	Type	Required	Description
`endpoint_id`	path	string	yes	Endpoint ID from List webhook endpoints
`limit`	query	integer	no	—
`after`	query	string	no	Opaque cursor from a previous response
`status`	query	PENDING \| SUCCEEDED \| FAILED	no	—

Response

200 — A page of deliveries.

Fields of the 200 response for listWebhookDeliveries
Field	Type	Description
`data`	array<object>	—
`has_more`	boolean	—
`next_cursor`	string \| null	—

Every response also carries X-Request-Id plus the IETF draft-11 RateLimit / RateLimit-Policy headers.

Errors

What can go wrong here.

Problem codes this operation can return
Code	Status	Meaning
`invalid_request`	400	The request body or parameters failed validation
`invalid_api_key`	401	Missing, malformed, unknown, disabled, or expired API key
`insufficient_scope`	403	The API key was not granted the required scope
`feature_not_enabled`	403	The workspace plan does not include public API access
`test_key_read_only`	403	Test-mode keys are restricted to read operations
`rate_limited`	429	Per-key rate limit exceeded
`quota_exhausted`	429	Monthly API quota exhausted
`internal_error`	500	Something went wrong on our side

All errors are RFC 9457 application/problem+json — branch on code, quote request_id to support. Full registry on the API docs hub; interactive playground in the API reference.