List Webhooks

List all configured webhooks.

Returns all webhooks configured for your business, optionally filtered by environment.

Endpoint

GET /v1/webhooks

Authentication

This endpoint requires a business-user JWT (not an API key).

Header	Value
Authorization	Bearer <jwt>

Required roles: BUSINESS_ADMIN, BUSINESS_OWNER, or BUSINESS_DEVELOPER.

Query parameters

Parameter	Type	Required	Description
environment	string	No	Filter by TEST or LIVE

Example request

cURL

curl -X GET "https://ramp-api.ivorypay.io/api/v1/webhooks?environment=LIVE" \
  -H "Authorization: Bearer <jwt>"

Node.js

const params = new URLSearchParams({
  environment: "LIVE",
});

const response = await fetch(`https://ramp-api.ivorypay.io/api/v1/webhooks?${params}`, {
  method: "GET",
  headers: {
    "Authorization": "Bearer <jwt>",
  },
});

const data = await response.json();
console.log(data);

Python

import requests

response = requests.get(
    "https://ramp-api.ivorypay.io/api/v1/webhooks",
    headers={
        "Authorization": "Bearer <jwt>",
    },
    params={
        "environment": "LIVE",
    },
)

print(response.json())

Go

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://ramp-api.ivorypay.io/api/v1/webhooks?environment=LIVE", nil)
	req.Header.Set("Authorization", "Bearer <jwt>")

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

Example response

{
  "success": true,
  "message": "Query successful",
  "data": [
    {
      "id": "wh-uuid-1",
      "url": "https://yourapp.com/webhooks/ivorypay",
      "environment": "LIVE",
      "events": ["onramp.success", "offramp.success", "deposit.received", "settlement.success"],
      "createdAt": "2026-03-26T12:00:00.000Z"
    }
  ]
}