curl --request GET \
--url https://api-sandbox.finogates.com/v1/platform/wallets/by-id/{wallet_id}/pending-incoming \
--header 'Authorization: Bearer <token>'import requests
url = "https://api-sandbox.finogates.com/v1/platform/wallets/by-id/{wallet_id}/pending-incoming"
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/wallets/by-id/{wallet_id}/pending-incoming', 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/wallets/by-id/{wallet_id}/pending-incoming",
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/wallets/by-id/{wallet_id}/pending-incoming"
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/wallets/by-id/{wallet_id}/pending-incoming")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-sandbox.finogates.com/v1/platform/wallets/by-id/{wallet_id}/pending-incoming")
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": {
"wallet_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"currency": "USD",
"total": "200.00",
"items": [
{
"intent_id": "a7b8c9d0-1234-5678-9abc-def012345678",
"amount": "200.00",
"currency": "USD",
"source_wallet_id": "b8c9d0e1-2345-6789-abcd-ef0123456789",
"created_at": "2026-06-02T08:00:00Z"
}
]
},
"query_generated_time": 1712847600000
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}List a Wallet's Incoming-Pending Transfers
List inbound transfers awaiting approval for a specific wallet by its UUID.
These are wallet-to-wallet transfers sent to this wallet that are held for
approval. The amounts are included in the wallet’s current balance but not
in available — they clear to available once approved, or return to the sender
if rejected. Each item carries the originating payment intent id, amount,
currency, sending wallet (when resolvable), and creation time.
The wallet must belong to your platform.
curl --request GET \
--url https://api-sandbox.finogates.com/v1/platform/wallets/by-id/{wallet_id}/pending-incoming \
--header 'Authorization: Bearer <token>'import requests
url = "https://api-sandbox.finogates.com/v1/platform/wallets/by-id/{wallet_id}/pending-incoming"
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/wallets/by-id/{wallet_id}/pending-incoming', 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/wallets/by-id/{wallet_id}/pending-incoming",
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/wallets/by-id/{wallet_id}/pending-incoming"
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/wallets/by-id/{wallet_id}/pending-incoming")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-sandbox.finogates.com/v1/platform/wallets/by-id/{wallet_id}/pending-incoming")
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": {
"wallet_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"currency": "USD",
"total": "200.00",
"items": [
{
"intent_id": "a7b8c9d0-1234-5678-9abc-def012345678",
"amount": "200.00",
"currency": "USD",
"source_wallet_id": "b8c9d0e1-2345-6789-abcd-ef0123456789",
"created_at": "2026-06-02T08:00:00Z"
}
]
},
"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
The wallet UUID.
Response
Inbound transfers to the wallet that are awaiting approval.
Standard response wrapper for single-object responses and errors.
Generic over the payload type. A route that declares
CommonResponse[SomeModel] gets the real data schema rendered in
OpenAPI/Swagger; a bare CommonResponse leaves data untyped.

