REST API›User Management Notification›Notification Webhooks

POST

Get or retrigger webhook notifications across multiple webhooks

Searches notification history across up to 25 webhooks and, optionally, resends the matches. Use this endpoint when you do not have specific notification IDs on hand and instead want to find (and optionally resend) notifications by criteria such as a time range, wallet, notification type, or coin. A common case is recovering from a downtime window on your endpoint: supply the webhook ID and a start/end time, set 'retrigger' to true, and every matching notification from that window is resent. If you already know the exact notification ID(s) you want to resend, use the single-webhook retrigger endpoint (POST /webhooks/{webhookId}/notifications/retrigger) instead.

Body Params

object

  • webhookIds array of strings required
    The webhook IDs whose notification history you want to search (max 25). Matching notifications across all listed webhooks are returned together.

    1 to 25 items

  • filters object
    Optional filters to narrow results
    filters object
    • start string
      Start timestamp (default: now - 1 day). Supports ISO 8601 datetime (2023-01-01T00:00:00Z) or simple date (2023-01-01).
    • end string
      End timestamp (default: now). Supports ISO 8601 datetime (2023-12-31T23:59:59Z) or simple date (2023-12-31).
    • enterpriseId string
      Filter by enterprise ID
    • organizationId string
      Filter by organization ID
    • walletId string
      Filter by wallet ID
    • type string
      Filter by notification type
    • coin string
      Filter by coin
  • offset integer int32 required
    Number of records to skip (default 0)

    >= 0

  • limit integer int32 required
    Number of records per page (default 50, max 50)

    >= 1 · <= 50

  • retrigger boolean required
    If true, every notification matched by this request is resent after being fetched. Set this when you want to resend all notifications matching your filters (for example, everything within a time window) without needing their individual notification IDs. The retrigger outcome (success or error) is returned inline on each notification. Subject to per-webhook rate limits (default 50/min). Default: false.

Responses

200
Bulk webhook notification history retrieved successfully

Response Body

object

  • notifications array of objects required
    notifications object
    • 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 map of objects
      response object
      • <key> object
    • coin string
    • walletId string
    • enterpriseId string
    • organizationId string
    • transferId string
    • hash string
    • retriggeredNotificationRequestId string
    • retriggerError string
  • metadata object required
    metadata object
    • total integer int64 required
    • limit integer int32 required
    • offset integer int32 required
400
Invalid request parameters

Response Body

object

Bad request error response
  • name string enum required
    Error code
    ValidationFailedIllegalArgumentBadRequestDataIntegrityErrorNotImplementedErrorRETRIGGER_RATE_LIMITEDUSER_CREATION_FAILEDUSER_FALLBACK_FAILED
  • error string required
    Human-readable error message
  • status integer enum int32 required
    HTTP status code
    400
403
Access denied for one or more webhook IDs

Response Body

object

Forbidden error response
  • name string enum required
    Error code
    AccessDenied
  • error string required
    Human-readable error message
  • status integer enum int32 required
    HTTP status code
    403
404
Webhook not found

Response Body

object

Not found error response
  • name string enum required
    Error code
    NotFound
  • error string required
    Human-readable error message
  • status integer enum int32 required
    HTTP status code
    404
500
Unexpected error occurred

Response Body

object

Internal server error response
  • name string enum required
    Error code
    UnexpectedErrorThirdPartyErrorDatabaseErrorUSER_FALLBACK_TIMEOUT
  • error string required
    Human-readable error message
  • status integer enum int32 required
    HTTP status code
    500