Skip to main content
GET
/
webhooks
/
events
List Webhook Events
curl --request GET \
  --url https://api.fyatu.com/api/v3/webhooks/events \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "status": 200,
  "message": "Webhook events retrieved",
  "data": {
    "appType": "ISSUING",
    "events": [
      {
        "event": "card.created",
        "name": "Card Created",
        "category": "card",
        "description": "Triggered when a new card is created for a cardholder"
      },
      {
        "event": "card.funded",
        "name": "Card Funded",
        "category": "card",
        "description": "Triggered when funds are added to a card"
      },
      {
        "event": "card.transaction.approved",
        "name": "Transaction Approved",
        "category": "card",
        "description": "Triggered when a card transaction is approved"
      },
      {
        "event": "cardholder.created",
        "name": "Cardholder Created",
        "category": "cardholder",
        "description": "Triggered when a new cardholder is created"
      },
      {
        "event": "cardholder.kyc_approved",
        "name": "KYC Approved",
        "category": "cardholder",
        "description": "Triggered when KYC verification is approved"
      }
    ],
    "total": 22
  },
  "meta": {
    "requestId": "req_abc123xyz789",
    "timestamp": "2026-01-15T10:30:00+00:00"
  }
}

List Webhook Events

Returns a list of all webhook event types that can be sent to your app. The events available depend on your app type (Issuing or Collection).

Request

curl -X GET https://api.fyatu.com/api/v3/webhooks/events \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Response

success
boolean
Whether the request was successful
data
object
{
  "success": true,
  "status": 200,
  "message": "Webhook events retrieved",
  "data": {
    "appType": "ISSUING",
    "events": [
      {
        "event": "card.created",
        "name": "Card Created",
        "category": "card",
        "description": "Triggered when a new card is created for a cardholder"
      },
      {
        "event": "card.funded",
        "name": "Card Funded",
        "category": "card",
        "description": "Triggered when funds are added to a card"
      },
      {
        "event": "card.transaction.approved",
        "name": "Transaction Approved",
        "category": "card",
        "description": "Triggered when a card transaction is approved"
      },
      {
        "event": "cardholder.created",
        "name": "Cardholder Created",
        "category": "cardholder",
        "description": "Triggered when a new cardholder is created"
      },
      {
        "event": "cardholder.kyc_approved",
        "name": "KYC Approved",
        "category": "cardholder",
        "description": "Triggered when KYC verification is approved"
      }
    ],
    "total": 22
  },
  "meta": {
    "requestId": "req_abc123xyz789",
    "timestamp": "2026-01-15T10:30:00+00:00"
  }
}

Event Categories

Issuing App Events

CategoryEvents
cardcard.created, card.funded, card.unloaded, card.frozen, card.unfrozen, card.terminated, card.replaced, card.transaction.approved, card.transaction.declined, card.transaction.reversed, card.maintenance_fee_paid
cardholdercardholder.created, cardholder.updated, cardholder.kyc_submitted, cardholder.kyc_approved, cardholder.kyc_rejected, cardholder.suspended, cardholder.activated
esimesim.purchased, esim.activated, esim.topped_up, esim.expired, esim.data_exhausted, esim.data_warning

Collection App Events

CategoryEvents
collectioncollection.initiated, collection.received, collection.failed, collection.expired
payoutpayout.initiated, payout.completed, payout.failed
refundrefund.initiated, refund.completed, refund.failed

Use Cases

  • Build a dynamic webhook handler that discovers available events
  • Display available events in your admin dashboard
  • Validate event types before testing

Authorizations

Authorization
string
header
required

JWT access token obtained from /auth/token

Response

Webhook events retrieved successfully

success
boolean
Example:

true

status
integer
Example:

200

message
string
data
object
meta
object