List transfers for account

Retrieves all transfers associated with an account. Can filter by account role (sender/receiver) and transfer status.

GET /accounts/{accountId}/transfers

List transfers for account

cURL

curl --request GET \
  --url https://api.venlyfinance.com/v1/accounts/{accountId}/transfers \
  --header 'Authorization: Bearer <token>'

400

{
  "success": false,
  "errors": [
    {
      "code": "VALIDATION_ERROR",
      "message": "The request contains invalid parameters."
    }
  ]
}

Authorizations

Authorization · string · header · required

OAuth2 client credentials flow. Token endpoints:

• Staging: https://login-staging.venly.io/auth/realms/VenlyFinance/protocol/openid-connect/token
• Production: https://login.venly.io/auth/realms/VenlyFinance/protocol/openid-connect/token

Path Parameters

accountId · string<uuid> · required

Query Parameters

accountRole · enum<string>

Filter by account role in the transfer

Available options: SENDER, RECEIVER

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

sortOn · string · default: createdAt

Field to sort by

sortOrder · enum<string> · default: ASC

Sort direction

Available options: ASC, DESC

Response

200

application/json

List of transfers