REST API›User Management Notification›Notification Webhooks

POST

Get or retrigger webhook notifications across multiple webhooks

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

Body Params

object

  • webhookIds array of strings required
    List of webhook IDs to fetch notifications for (max 25)

    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, 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.

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