Get a Wallet's Activity by ID

curl --request GET \
  --url https://api-sandbox.finogates.com/v1/platform/wallets/by-id/{wallet_id}/activity \
  --header 'Authorization: Bearer <token>'

{
  "status_code": 123,
  "data": "<unknown>",
  "query_generated_time": 123
}

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, and current.
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.

GET

platform

wallets

by-id

{wallet_id}

activity

Get a Wallet's Activity by ID

curl --request GET \
  --url https://api-sandbox.finogates.com/v1/platform/wallets/by-id/{wallet_id}/activity \
  --header 'Authorization: Bearer <token>'

{
  "status_code": 123,
  "data": "<unknown>",
  "query_generated_time": 123
}

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

wallet_id

string<uuid>

required

The wallet UUID.

Response

Successful Response

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.

status_code

integer

required

HTTP status code for the response.

data

any

required

Payload or error details.

query_generated_time

integer

required

UTC timestamp (milliseconds since epoch) when response was generated.

Get a Wallet by ID List a Wallet's Incoming-Pending Transfers