Get Payout Destination
curl --request GET \
--url https://api.hopnow.io/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payout-destinations/{destination_id} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hopnow.io/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payout-destinations/{destination_id}"
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/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payout-destinations/{destination_id}', 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/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payout-destinations/{destination_id}",
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/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payout-destinations/{destination_id}"
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/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payout-destinations/{destination_id}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hopnow.io/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payout-destinations/{destination_id}")
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{
"id": "<string>",
"object": "<string>",
"beneficiary_id": "<string>",
"country": "<string>",
"payment_rails": [
{}
],
"type": "<string>",
"label": "<string>",
"currency": "<string>",
"network": "<string>",
"status": "<string>",
"account_name": "<string>",
"account_number_last4": "<string>",
"account_type": "<string>",
"routing_number": "<string>",
"swift_code": "<string>",
"iban_masked": "<string>",
"clabe_last4": "<string>",
"pix_key_last4": "<string>",
"wallet_address_masked": "<string>",
"bank_name": "<string>",
"bank_address": {},
"correspondent_bank_name": "<string>",
"correspondent_bank_address": {},
"correspondent_bank_swift": "<string>",
"account_holder": "<string>",
"created": "<string>",
"updated": "<string>",
"created_by": "<string>",
"updated_by": "<string>"
}Payout Destinations
Get Payout Destination
Retrieve a specific payout destination
GET
/
v1
/
accounts
/
{account_id}
/
beneficiaries
/
{beneficiary_id}
/
payout-destinations
/
{destination_id}
Get Payout Destination
curl --request GET \
--url https://api.hopnow.io/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payout-destinations/{destination_id} \
--header 'X-API-Key: <api-key>'import requests
url = "https://api.hopnow.io/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payout-destinations/{destination_id}"
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/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payout-destinations/{destination_id}', 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/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payout-destinations/{destination_id}",
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/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payout-destinations/{destination_id}"
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/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payout-destinations/{destination_id}")
.header("X-API-Key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.hopnow.io/v1/accounts/{account_id}/beneficiaries/{beneficiary_id}/payout-destinations/{destination_id}")
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{
"id": "<string>",
"object": "<string>",
"beneficiary_id": "<string>",
"country": "<string>",
"payment_rails": [
{}
],
"type": "<string>",
"label": "<string>",
"currency": "<string>",
"network": "<string>",
"status": "<string>",
"account_name": "<string>",
"account_number_last4": "<string>",
"account_type": "<string>",
"routing_number": "<string>",
"swift_code": "<string>",
"iban_masked": "<string>",
"clabe_last4": "<string>",
"pix_key_last4": "<string>",
"wallet_address_masked": "<string>",
"bank_name": "<string>",
"bank_address": {},
"correspondent_bank_name": "<string>",
"correspondent_bank_address": {},
"correspondent_bank_swift": "<string>",
"account_holder": "<string>",
"created": "<string>",
"updated": "<string>",
"created_by": "<string>",
"updated_by": "<string>"
}Returns one payout destination of a beneficiary owned by the account. Account numbers, IBANs, PIX keys, CLABEs and wallet addresses are always returned masked.
Requires an API key with
read access on the payments scope.
Path Parameters
string
required
The account’s external ID (starts with
acct_)string
required
The beneficiary’s external ID (starts with
bene_)string
required
The payout destination’s external ID (starts with
dest_)Response
string
Payout destination identifier (starts with
dest_)string
Always returns
"payout_destination"string
Parent beneficiary external ID
string
Payout country
array
Payout rails Hop derived from the destination details:
crypto for a wallet, pix when a PIX key was sent, spei for a Mexican account, swift for any other bank account. Always carries at least one element.string
Destination type:
bank_account or walletstring
Destination label, or
nullstring
Currency
string
Blockchain network for a wallet,
null for a bank accountstring
Destination status:
active, pending, or disabled. A wallet stays pending until Hop reviews it, and the outcome (active or disabled) raises payout_destination.updated. Only an active destination can be paid.string
Name on the receiving account, or
nullstring
Account number masked as four asterisks plus the last 4 characters, for example
****7890string
Account type as supplied at creation. Free text, not a fixed set of values.
string
Bank routing number, or
nullstring
SWIFT/BIC code, or
nullstring
IBAN masked as the first 4 characters, four asterisks, and the last 4, for example
GB29****6819string
CLABE masked as
**** plus the last 4 digits. For a Mexican destination this and account_number_last4 carry the same digits.string
PIX key masked as
**** plus the last 4 charactersstring
Wallet address masked as the first 6 characters, four asterisks, and the last 4, for example
0x742d****0bEbstring
Receiving bank name, or
nullobject
Receiving bank address (
address_line, city, region, postal_code, country), or nullstring
Correspondent bank name, or
nullobject
Correspondent bank address, same shape as
bank_address, or nullstring
Correspondent bank SWIFT/BIC code, or
nullstring
Account holder, when it differs from
account_name, or nullstring
ISO 8601 timestamp when created
string
ISO 8601 timestamp when last updated
string
ID of the API key that created the destination (starts with
ak_)string
Actor that last updated the destination, or
nullErrors
| Status | code | When |
|---|---|---|
404 | RESOURCE_NOT_FOUND | No such destination or beneficiary, either belongs to another account, or either has been deleted |
Response Example
{
"id": "dest_7hq3nd0xk52vplf9rtb1wcue",
"object": "payout_destination",
"beneficiary_id": "bene_9gt1ummgx127biovlurm9mq2",
"country": "US",
"payment_rails": ["swift"],
"type": "bank_account",
"label": "Main Account",
"currency": "USD",
"network": null,
"status": "active",
"account_name": "John Doe",
"account_number_last4": "****7890",
"account_type": "checking",
"routing_number": "021000021",
"swift_code": null,
"iban_masked": null,
"clabe_last4": null,
"pix_key_last4": null,
"wallet_address_masked": null,
"bank_name": "Example Bank",
"bank_address": null,
"correspondent_bank_name": null,
"correspondent_bank_address": null,
"correspondent_bank_swift": null,
"account_holder": null,
"created": "2026-01-15T10:05:00Z",
"updated": "2026-01-15T10:05:00Z",
"created_by": "ak_0ub5w2xr8yl3qks6tcdn7m4v",
"updated_by": null
}