List Payment Destinations
curl --request GET \
--url https://api.hopnow.io/va/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hopnow.io/va/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations"
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://api.hopnow.io/va/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations', 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://api.hopnow.io/va/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations",
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://api.hopnow.io/va/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations"
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://api.hopnow.io/va/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hopnow.io/va/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"items": [
{
"object": "payment_destination",
"id": "dest_8kpw2x7a3b9c1e5f2d4g6h8j",
"beneficiary_id": "bene_5tql9z7a3b9c1e5f2d4g6h8j",
"country": "GB",
"payment_method": "wire",
"type": "bank_account",
"label": "Globex GBP",
"currency": "GBP",
"status": "active",
"account_number_last4": "****6819",
"iban_masked": "GB29****6819",
"pix_key_masked": null,
"is_default": true,
"created": "2026-05-01T10:05:00Z",
"updated": null
}
],
"page": 1,
"size": 10,
"total": 1,
"pages": 1
}
Payment Destinations
List Payment Destinations
List a beneficiary’s payment destinations with pagination and filters
GET
/
va
/
v1
/
accounts
/
{account_id}
/
beneficiaries
/
{beneficiary_id}
/
payment-destinations
List Payment Destinations
curl --request GET \
--url https://api.hopnow.io/va/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hopnow.io/va/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations"
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://api.hopnow.io/va/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations', 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://api.hopnow.io/va/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations",
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://api.hopnow.io/va/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations"
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://api.hopnow.io/va/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hopnow.io/va/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"items": [
{
"object": "payment_destination",
"id": "dest_8kpw2x7a3b9c1e5f2d4g6h8j",
"beneficiary_id": "bene_5tql9z7a3b9c1e5f2d4g6h8j",
"country": "GB",
"payment_method": "wire",
"type": "bank_account",
"label": "Globex GBP",
"currency": "GBP",
"status": "active",
"account_number_last4": "****6819",
"iban_masked": "GB29****6819",
"pix_key_masked": null,
"is_default": true,
"created": "2026-05-01T10:05:00Z",
"updated": null
}
],
"page": 1,
"size": 10,
"total": 1,
"pages": 1
}
Returns a paginated list of payment destinations for a beneficiary, wrapped in the standard paginated envelope.
Path Parameters
string
required
Id of the parent account (e.g.
acct_...).string
required
Beneficiary id (e.g.
bene_…).Query Parameters
integer
default:"1"
Page number, starting at 1. Default 1.
integer
default:"10"
Items per page. Default 10.
array
Filter by status:
active, pending, disabled.datetime
Created-at lower bound (inclusive).
datetime
Created-at upper bound (exclusive).
Response
Returns 200 with a paginated list of payment destination objects. Account identifiers are always masked.object[]
The payment destination objects on this page. Each item has the same masked shape as Get Payment Destination.
integer
Current page number.
integer
Items per page.
integer
Total number of items.
integer
Total number of pages.
{
"items": [
{
"object": "payment_destination",
"id": "dest_8kpw2x7a3b9c1e5f2d4g6h8j",
"beneficiary_id": "bene_5tql9z7a3b9c1e5f2d4g6h8j",
"country": "GB",
"payment_method": "wire",
"type": "bank_account",
"label": "Globex GBP",
"currency": "GBP",
"status": "active",
"account_number_last4": "****6819",
"iban_masked": "GB29****6819",
"pix_key_masked": null,
"is_default": true,
"created": "2026-05-01T10:05:00Z",
"updated": null
}
],
"page": 1,
"size": 10,
"total": 1,
"pages": 1
}
⌘I