curl --request GET \
--url https://api-sandbox.finogates.com/v1/platform/wallets/by-id/{wallet_id}/activity \
--header 'Authorization: Bearer <token>'import requests
url = "https://api-sandbox.finogates.com/v1/platform/wallets/by-id/{wallet_id}/activity"
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}/activity', 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}/activity",
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}/activity"
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}/activity")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-sandbox.finogates.com/v1/platform/wallets/by-id/{wallet_id}/activity")
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": {
"balances": {
"available": 1000,
"outbound_pending": 0,
"inbound_pending": 200,
"current": 1200
},
"rows": [
{
"intent_id": "d4e5f6a7-b8c9-0123-4567-89abcdef0123",
"journey": "Bank to Wallet Settled",
"status": "succeeded",
"created_at": "2026-06-01T14:05:00Z",
"amount": 500,
"amount_sign": 1,
"available_balance_at_creation": 500,
"last_event_at": "2026-06-01T14:07:12Z",
"currency": "USD"
},
{
"intent_id": "e5f6a7b8-c9d0-1234-5678-9abcdef01234",
"journey": "Wallet to Bank Settled",
"status": "succeeded",
"created_at": "2026-05-28T09:12:00Z",
"amount": 120,
"amount_sign": -1,
"available_balance_at_creation": 620,
"last_event_at": "2026-05-28T09:15:40Z",
"currency": "USD"
}
]
},
"query_generated_time": 1712847600000
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Get a Wallet's Activity by ID
Get the money in-and-out history for a specific wallet by its UUID.
Unlike GET /{user_id}/activity — which only ever returns the user’s
primary wallet’s activity — this works for any wallet you own
(primary or not, user or master), so every wallet’s history is reachable.
Use the wallet_id from List All Wallets, List a User's Wallets, or a
payment intent.
You get back the same shape as the by-user activity endpoint:
- Balances —
available,outbound_pending,inbound_pending, andcurrent. - Activity list — one entry per payment, newest first, each with the
journey, status, amount, direction (
amount_sign), and timestamps.
The wallet must belong to your platform.
curl --request GET \
--url https://api-sandbox.finogates.com/v1/platform/wallets/by-id/{wallet_id}/activity \
--header 'Authorization: Bearer <token>'import requests
url = "https://api-sandbox.finogates.com/v1/platform/wallets/by-id/{wallet_id}/activity"
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}/activity', 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}/activity",
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}/activity"
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}/activity")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-sandbox.finogates.com/v1/platform/wallets/by-id/{wallet_id}/activity")
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": {
"balances": {
"available": 1000,
"outbound_pending": 0,
"inbound_pending": 200,
"current": 1200
},
"rows": [
{
"intent_id": "d4e5f6a7-b8c9-0123-4567-89abcdef0123",
"journey": "Bank to Wallet Settled",
"status": "succeeded",
"created_at": "2026-06-01T14:05:00Z",
"amount": 500,
"amount_sign": 1,
"available_balance_at_creation": 500,
"last_event_at": "2026-06-01T14:07:12Z",
"currency": "USD"
},
{
"intent_id": "e5f6a7b8-c9d0-1234-5678-9abcdef01234",
"journey": "Wallet to Bank Settled",
"status": "succeeded",
"created_at": "2026-05-28T09:12:00Z",
"amount": 120,
"amount_sign": -1,
"available_balance_at_creation": 620,
"last_event_at": "2026-05-28T09:15:40Z",
"currency": "USD"
}
]
},
"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
The wallet's balance breakdown and recent activity.
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.

