List a Wallet's Incoming-Pending Transfers

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

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

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.

GET

platform

wallets

by-id

{wallet_id}

pending-incoming

List a Wallet's Incoming-Pending Transfers

curl --request GET \
  --url https://api-sandbox.finogates.com/v1/platform/wallets/by-id/{wallet_id}/pending-incoming \
  --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's Activity by ID Rename or Promote a Wallet