List Webhook Requests

GET /api/v2/webhooks/requests

The List Webhook Requests endpoint retrieves the list of all webhook event notifications sent to the business.

Query Parameters

Name	Type	Description	Required
page	integer	The current page number in pagination. Minimum: 1 Default: 1	false
size	integer	The size or number of records per page. Minimum: 1 Default: 10	false
event_type	string	Type of webhook request. Refer to Webhook events Example: TRAVEL_RULE	false
event_name	string	Name of webhook request. Refer to Webhook events Example: INCOMING_TRANSFER	false

RESPONSE

{
    "status": "success",
    "data": {
        "items": [
            {
                "id": "06859059-fb46-7ec1-8000-56fc7aa163ae",
                "webhook_url": "https://example.com",
                "event_type": "TRAVEL_RULE",
                "event_name": "TRANSFER_ACCEPTED",
                "status": 200,
                "request_payload": {
                    "data": {
                        "dti": "4H95J0R2X",
                        "chain": "bitcoin",
                        "amount": 4.2,
                        "symbol": "BTC",
                        "protocol": "flow",
                        "amount_usd": 428462.12,
                        "transfer_id": "06858fb9-bae1-79cd-8000-3094dc29f766",
                        "reference_id": "65HIgpJqAUmc664atmlO",
                        "transfer_status": "ACCEPTED",
                        "transaction_hash": null,
                        "originator_address_is_self_hosted": true,
                        "beneficiary_address_is_self_hosted": false
                    },
                    "error": null,
                    "timestamp": "2025-06-23T07:00:43.717046+00:00",
                    "event_name": "TRANSFER_ACCEPTED",
                    "event_type": "TRAVEL_RULE",
                    "request_id": "06859059-fb46-7ec1-8000-56fc7aa163ae"
                },
                "error_details": null,
                "timestamp": "2025-06-24T04:38:34.141086+00:00"
            },
            {
                "id": "06859755-5e06-7706-8000-5bbe7c7fb567",
                "webhook_url": "https://example.com",
                "event_type": "TRAVEL_RULE",
                "event_name": "TRANSFER_ACCEPTED",
                "status": 404,
                "request_payload": {
                    "data": {
                        "dti": "4H95J0R2X",
                        "chain": "bitcoin",
                        "amount": 1,
                        "symbol": "BTC",
                        "protocol": "flow",
                        "amount_usd": 101717.98,
                        "transfer_id": "0685974a-1bf5-7dfa-8000-fec046c7692c",
                        "reference_id": "ref-id-jun23-003",
                        "transfer_status": "ACCEPTED",
                        "transaction_hash": null,
                        "originator_address_is_self_hosted": true,
                        "beneficiary_address_is_self_hosted": false
                    },
                    "error": null,
                    "timestamp": "2025-06-23T15:37:07.201117+00:00",
                    "event_name": "TRANSFER_ACCEPTED",
                    "event_type": "TRAVEL_RULE",
                    "request_id": "06859755-5e06-7706-8000-5bbe7c7fb567"
                },
                "error_details": {
                    "error": "Client error '404 Not Found' for url 'https://example.com'\nFor more information check: https://httpstatuses.com/404",
                    "response_text": "http error...",
                    "attempt_number": 1
                },
                "timestamp": "2025-06-24T04:38:00.499472+00:00"
            }
        ],
        "total": 10,
        "page": 1,
        "size": 2
    }
}