Delete a Beneficiary

Overview

Deletes an existing beneficiary record from the platform. The beneficiary must not have active, pending payment transactions.

HTTP Request

DELETE /banking/ibans/v2/profile/v2.1/beneficiaries/{id}

Authentication

This endpoint requires an active Bearer JWT token in the Authorization header obtained via POST /banking/ibans/v2/users/login:

Authorization: Bearer <your_access_token>

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	Unique identifier of the beneficiary to delete (e.g. 2435)

Code Examples

cURL

curl -X DELETE "https://api.ahrvo.network/banking/ibans/v2/profile/v2.1/beneficiaries/{id}" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <your_access_token>"

JavaScript (Axios)

import axios from 'axios';

const response = await axios.delete('https://api.ahrvo.network/banking/ibans/v2/profile/v2.1/beneficiaries/{id}', {
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer <your_access_token>'
  }
});

console.log(response.data);

Python (Requests)

import requests

url = "https://api.ahrvo.network/banking/ibans/v2/profile/v2.1/beneficiaries/{id}"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer <your_access_token>" 
}

response = requests.delete(url, headers=headers)
print(response.json())

Response (200)

{
  "success": true
}

Interactive API Explorer

Test this endpoint live against the Ahrvo gateway and Verto sandbox environments: