Skip to main content
GET
/
integrations
/
vertofx
/
beneficiaries
/
{id}
Get Beneficiary Details
curl --request GET \
  --url https://api.royalti.io/integrations/vertofx/beneficiaries/{id} \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": {
    "id": 4754,
    "accountNumber": "2092805598",
    "bankName": "United Bank for Africa Plc",
    "firstName": "John",
    "lastName": "Doe",
    "currency": "NGN",
    "beneficiaryCountryCode": "NG"
  }
}
This endpoint requires authentication. Include your Bearer token in the Authorization header.

​
Description

Description:
The /integrations/vertofx/beneficiaries/{id} endpoint retrieves detailed information about a specific beneficiary. Method: GET Path Parameter:
ParameterTypeDescription
idstringThe unique identifier of the beneficiary

​
Code Examples

const response = await fetch('https://api.royalti.io/integrations/vertofx/beneficiaries/example-id', {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${token}`,
  },
});

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

Authorizations

​
Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Path Parameters

​
id
string
required

Beneficiary ID

Response

Success

​
success
boolean
​
data
object