curl --request GET \
--url https://api-sandbox.finogates.com/v1/platform/payees/bank-accounts/{payee_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api-sandbox.finogates.com/v1/platform/payees/bank-accounts/{payee_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-sandbox.finogates.com/v1/platform/payees/bank-accounts/{payee_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-sandbox.finogates.com/v1/platform/payees/bank-accounts/{payee_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 => [
"Authorization: Bearer <token>"
],
]);
$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-sandbox.finogates.com/v1/platform/payees/bank-accounts/{payee_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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-sandbox.finogates.com/v1/platform/payees/bank-accounts/{payee_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-sandbox.finogates.com/v1/platform/payees/bank-accounts/{payee_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"status_code": 200,
"data": [
{
"id": "f1e2d3c4-b5a6-7890-1234-567890abcdef",
"payee_id": "d4e5f6a7-b8c9-0123-4567-890abcdef012",
"nickname": "Acme — Operating",
"account_holder_name": "Acme Supplier LLC",
"bank_name": "Example Bank",
"bank_country": "US",
"currency": "USD",
"rail_code": "ach",
"account_type": "checking",
"account_last4": "6789",
"routing_last4": "0021",
"status": "active",
"created_at": "2025-06-10T18:12:00.000Z",
"updated_at": "2025-06-10T18:12:00.000Z"
},
{
"id": "0a1b2c3d-4e5f-6789-abcd-ef0123456789",
"payee_id": "d4e5f6a7-b8c9-0123-4567-890abcdef012",
"nickname": "Acme — India payouts",
"account_holder_name": "Acme Supplier Pvt Ltd",
"bank_name": "State Bank of India",
"bank_country": "IN",
"currency": "INR",
"rail_code": "wire",
"account_last4": "4321",
"bank_branch": "SBIN0001234",
"bank_document": "ABCDE1234F",
"payout_branch_id": 4821,
"status": "active",
"created_at": "2025-06-11T08:30:00.000Z",
"updated_at": "2025-06-11T08:30:00.000Z"
}
],
"row_count": 2,
"query_generated_time": 1712847600000
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}List a Payee's Bank Accounts
Return every active bank account that has been saved for this payee. Revoked (deleted) accounts are not included. Each entry shows only the last four digits of the account and routing numbers.
curl --request GET \
--url https://api-sandbox.finogates.com/v1/platform/payees/bank-accounts/{payee_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api-sandbox.finogates.com/v1/platform/payees/bank-accounts/{payee_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-sandbox.finogates.com/v1/platform/payees/bank-accounts/{payee_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-sandbox.finogates.com/v1/platform/payees/bank-accounts/{payee_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 => [
"Authorization: Bearer <token>"
],
]);
$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-sandbox.finogates.com/v1/platform/payees/bank-accounts/{payee_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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-sandbox.finogates.com/v1/platform/payees/bank-accounts/{payee_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-sandbox.finogates.com/v1/platform/payees/bank-accounts/{payee_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"status_code": 200,
"data": [
{
"id": "f1e2d3c4-b5a6-7890-1234-567890abcdef",
"payee_id": "d4e5f6a7-b8c9-0123-4567-890abcdef012",
"nickname": "Acme — Operating",
"account_holder_name": "Acme Supplier LLC",
"bank_name": "Example Bank",
"bank_country": "US",
"currency": "USD",
"rail_code": "ach",
"account_type": "checking",
"account_last4": "6789",
"routing_last4": "0021",
"status": "active",
"created_at": "2025-06-10T18:12:00.000Z",
"updated_at": "2025-06-10T18:12:00.000Z"
},
{
"id": "0a1b2c3d-4e5f-6789-abcd-ef0123456789",
"payee_id": "d4e5f6a7-b8c9-0123-4567-890abcdef012",
"nickname": "Acme — India payouts",
"account_holder_name": "Acme Supplier Pvt Ltd",
"bank_name": "State Bank of India",
"bank_country": "IN",
"currency": "INR",
"rail_code": "wire",
"account_last4": "4321",
"bank_branch": "SBIN0001234",
"bank_document": "ABCDE1234F",
"payout_branch_id": 4821,
"status": "active",
"created_at": "2025-06-11T08:30:00.000Z",
"updated_at": "2025-06-11T08:30:00.000Z"
}
],
"row_count": 2,
"query_generated_time": 1712847600000
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Path Parameters
Query Parameters
Optional. The unique ID of the user who owns this payee. Omit to look the payee up by its ID within your tenant.
"b3a9b622-cc63-4d3c-aad6-2d8e29e6f9d4"
Response
The payee's active bank accounts (sensitive numbers masked).
HTTP status code for the response.
Payload or error details.
Show child attributes
Show child attributes
UTC timestamp (milliseconds since epoch) when response was generated.
Total rows matching the request filters (not just this page).
x >= 0Page size used for this response. Null for cursor-paginated endpoints.
x >= 11-indexed page number for this response. Null for cursor-paginated endpoints.
x >= 1Total number of pages given the current limit. Null for cursor-paginated endpoints.
x >= 0Cursor for the next page, if available.

