Get or retrigger webhook notifications across multiple webhooks

post/api/notifications/v1/webhooks/notifications

Retrieves and optionally retriggers paginated notification history for up to 25 webhook IDs with optional filters.

Request Body

Webhook IDs, optional filters, pagination parameters, and whether to retrigger the notifications
webhookIds array[string] required
List of webhook IDs to fetch notifications for (max 25)
Min items: >= 1 items
Max items: <= 25 items
filters object
Optional filters to narrow results
start string
Start timestamp (default: now - 1 day). Supports ISO 8601 datetime (2023-01-01T00:00:00Z) or simple date (2023-01-01).
Example: 2023-01-01T00:00:00.000Z
end string
End timestamp (default: now). Supports ISO 8601 datetime (2023-12-31T23:59:59Z) or simple date (2023-12-31).
Example: 2023-12-31T23:59:59.000Z
enterpriseId string
Filter by enterprise ID
Example: ent-abc123
organizationId string
Filter by organization ID
Example: org-xyz789
walletId string
Filter by wallet ID
Example: wallet-def456
type string
Filter by notification type
Example: transfer
coin string
Filter by coin
Example: btc
offset integer <int32>required
Number of records to skip (default 0)
Minimum: >= 0
Example: 0
limit integer <int32>required
Number of records per page (default 50, max 50)
Minimum: >= 1
Maximum: <= 50
Example: 50
retrigger boolean required
If true, all matched notifications are retriggered after fetching. Retrigger outcome (success or error) is returned inline on each notification. Subject to per-webhook rate limits (default 50/min). Default: false.
Example: false

200 Response

notifications array[object] required
id string <uuid>required
webhookId string required
notificationRequestId string required
url string required
payload string required
type string required
status string required
retries integer <int32>required
createdAt string <date-time>required
updatedAt string <date-time>required
response dictionary<string, object>
coin string
walletId string
enterpriseId string
organizationId string
transferId string
hash string
retriggeredNotificationRequestId string
retriggerError string
metadata object required
total integer <int64>required
limit integer <int32>required
offset integer <int32>required

400 Response

name string required
Error code
Allowed values: ValidationFailed IllegalArgument BadRequest DataIntegrityError NotImplementedError RETRIGGER_RATE_LIMITED USER_CREATION_FAILED USER_FALLBACK_FAILED
error string required
Human-readable error message
status integer <int32>required
HTTP status code
Allowed value: 400

403 Response

name string required
Error code
Allowed value: AccessDenied
error string required
Human-readable error message
status integer <int32>required
HTTP status code
Allowed value: 403

500 Response

name string required
Error code
Allowed values: UnexpectedError ThirdPartyError DatabaseError USER_FALLBACK_TIMEOUT
error string required
Human-readable error message
status integer <int32>required
HTTP status code
Allowed value: 500