Skip to main content
GET
List transfers for account
Requires scope: manage:transfers — see Required scopes. Returns the account’s transfers. Filter by accountRole (SENDER/RECEIVER) and status, and page with page/size (see Pagination). Concept guide: Transfers

Authorizations

FlowClient Credentials
Token URL
https://login-staging.venly.io/auth/realms/VenlyFinance/protocol/openid-connect/token

Headers

x-tenant-id
string<uuid>

Which tenant the request is scoped to, among those your token grants. Omit it when the token grants exactly one tenant; it is required when the token grants more than one. A supplied value must exactly match a tenant the token grants.

Absent when required, blank, malformed, or naming a tenant the token does not grant — each gets the same generic 403 forbidden, which reveals neither whether a tenant exists nor which ones you may use. Send the header once: a repeated header is rejected the same way.

Example:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

Path Parameters

accountId
string<uuid>
required

Unique account identifier

Query Parameters

accountRole
enum<string>

Filter by the account's role in the transfer

Available options:
SENDER,
RECEIVER
status
enum<string>

Filter by transfer status Status of a transfer

Available options:
PENDING,
COMPLETED,
FAILED
sortOn
string
default:createdAt

Field to sort by. When omitted, results are ordered by createdAt descending.

sortOrder
enum<string>
default:DESC

Sort direction. Applied only together with sortOn — on its own it is ignored and the default ordering (createdAt descending) is used, so ?sortOrder=ASC alone does not reverse a list.

Available options:
ASC,
DESC
page
integer<int32>
default:1

Page number (1-based indexing)

Required range: x >= 1
size
integer<int32>
default:100

Number of items per page

Required range: x >= 1

Response

List of transfers

success
boolean

Indicates whether the request was successful

result
object[]
pagination
object

Pagination metadata (top-level sibling of result)