Skip to main content
GET
/
v1
/
webhooks
/
events
List webhook events
curl --request GET \
  --url https://api.rem.money/v1/webhooks/events \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "<string>",
    "type": "<string>",
    "delivered": true,
    "created_at": "2023-11-07T05:31:56Z",
    "payload": {}
  }
]
Every accept, transfer, and redeem fires a signed webhook. Use this endpoint to inspect delivery status, debug, or replay events.

​
Event types

EventWhen it fires
accept.confirmedAn inbound USDC deposit has been confirmed onchain
transfer.settledA transfer has settled on its target chain
transfer.failedA transfer failed compliance, routing, or onchain submission
redeem.completedA fiat redemption has completed at the destination bank
redeem.failedA redemption failed at the bank or compliance layer

​
Signature verification

Every payload includes an X-REM-Signature header (HMAC-SHA256 of the raw body, keyed by your webhook secret). Verify with @rem-money/sdk: 
import { verifyWebhook } from "@rem-money/sdk";

const isValid = verifyWebhook({
  payload: rawBody,
  signature: req.headers["x-rem-signature"],
  secret: process.env.REM_WEBHOOK_SECRET,
});

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
type
string
​
limit
integer
default:50

Response

200 - application/json

Webhook events

​
id
string
​
type
string
Examples:

"accept.confirmed"

"transfer.settled"

"redeem.completed"

​
delivered
boolean
​
created_at
string<date-time>
​
payload
object