List Payment Destinations

curl --request GET \
  --url https://api.hopnow.io/ads/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://api.hopnow.io/ads/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/ads/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/ads/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/ads/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/ads/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/ads/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
}

GET

ads

accounts

{account_id}

beneficiaries

{beneficiary_id}

payment-destinations

List Payment Destinations

curl --request GET \
  --url https://api.hopnow.io/ads/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payment-destinations \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://api.hopnow.io/ads/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/ads/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/ads/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/ads/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/ads/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/ads/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
}

Create Payment Destination Get Payment Destination

Getting Started

Integration Flows

Webhooks

Endpoints

List Payment Destinations

Path Parameters

Query Parameters

Response

​Path Parameters

​Query Parameters

​Response

Path Parameters

Query Parameters

Response