List Webhook Endpoints

curl --request GET \
  --url https://your-endpoint.moduluslabs.io/v1/webhooks/endpoints \
  --header 'x-api-key: <api-key>'

import requests

url = "https://your-endpoint.moduluslabs.io/v1/webhooks/endpoints"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://your-endpoint.moduluslabs.io/v1/webhooks/endpoints', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://your-endpoint.moduluslabs.io/v1/webhooks/endpoints",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://your-endpoint.moduluslabs.io/v1/webhooks/endpoints"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://your-endpoint.moduluslabs.io/v1/webhooks/endpoints")
  .header("x-api-key", "<api-key>")
  .asString();

using RestSharp;


var options = new RestClientOptions("https://your-endpoint.moduluslabs.io/v1/webhooks/endpoints");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("x-api-key", "<api-key>");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);

{
  "endpoints": [
    {
      "endpointId": "wh_01HQ3K4M5N6P7R8S9T0UVWXYZ",
      "url": "https://api.yourcompany.com/webhooks/payments",
      "events": [
        "payment.completed",
        "payment.failed",
        "payment.cancelled",
        "payment.timeout"
      ],
      "description": "Production payment notifications",
      "status": "active",
      "metadata": {
        "environment": "production"
      },
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z"
    }
  ],
  "count": 1,
  "timestamp": "2024-01-15T10:35:00.000Z"
}

GET

webhooks

endpoints

List Webhook Endpoints

curl --request GET \
  --url https://your-endpoint.moduluslabs.io/v1/webhooks/endpoints \
  --header 'x-api-key: <api-key>'

import requests

url = "https://your-endpoint.moduluslabs.io/v1/webhooks/endpoints"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://your-endpoint.moduluslabs.io/v1/webhooks/endpoints', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://your-endpoint.moduluslabs.io/v1/webhooks/endpoints",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://your-endpoint.moduluslabs.io/v1/webhooks/endpoints"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://your-endpoint.moduluslabs.io/v1/webhooks/endpoints")
  .header("x-api-key", "<api-key>")
  .asString();

using RestSharp;


var options = new RestClientOptions("https://your-endpoint.moduluslabs.io/v1/webhooks/endpoints");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("x-api-key", "<api-key>");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);

{
  "endpoints": [
    {
      "endpointId": "wh_01HQ3K4M5N6P7R8S9T0UVWXYZ",
      "url": "https://api.yourcompany.com/webhooks/payments",
      "events": [
        "payment.completed",
        "payment.failed",
        "payment.cancelled",
        "payment.timeout"
      ],
      "description": "Production payment notifications",
      "status": "active",
      "metadata": {
        "environment": "production"
      },
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z"
    }
  ],
  "count": 1,
  "timestamp": "2024-01-15T10:35:00.000Z"
}

This endpoint requires HMAC-SHA256 authentication. See Authentication for signature computation details.

Response Details

The response includes all webhook endpoints configured for your group, including:

Active endpoints that are receiving webhooks
Disabled endpoints that have been paused but not deleted

The webhook signing secret is not included in list responses. It is only returned once during endpoint creation.

Endpoint Status

Status	Description
`active`	Endpoint is receiving webhook deliveries
`disabled`	Endpoint is paused; no webhooks are delivered

Authorizations

x-api-key

string

header

required

HMAC-SHA256 authentication. Requires three headers: x-api-key (your API key), x-timestamp (ISO 8601 timestamp), and x-signature (Base64-encoded HMAC-SHA256 signature). See Authentication documentation for signature computation.

Response

List of webhook endpoints

endpoints

object[]

required

List of webhook endpoints

Show child attributes

count

integer

required

Total number of endpoints

timestamp

string<date-time>

required

ISO 8601 timestamp of the response

Create Webhook Endpoint Get Webhook Endpoint

QR API

Onboarding API

Transaction Reporting API

Terminal Gateway API

Ecom API

List Webhook Endpoints

Response Details

Endpoint Status

Authorizations

Response

​Response Details

​Endpoint Status

Authorizations

Response

Response Details

Endpoint Status