Skip to main content
GET
/
accounts
/
{accountId}
/
party-roles
List party roles for an account
curl --request GET \
  --url https://api.venlyfinance.com/v1/accounts/{accountId}/party-roles \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "result": [
    {
      "partyId": "7e3b9c2a-1f4d-4a8b-9c11-2d6e8f0a1b22",
      "roleType": "ACCOUNT_HOLDER",
      "status": "ACTIVE",
      "createdAt": "2026-01-15T09:30:00",
      "updatedAt": "2026-01-15T09:30:00"
    }
  ]
}
Returns the party-role links for an account (for example, the ACCOUNT_HOLDER). This is a plain array — it is not paginated.

Authorizations

​
Authorization
string
header
required

OAuth2 client credentials flow. Token endpoints:

Path Parameters

​
accountId
string<uuid>
required

Unique account identifier

Response

List of party roles

​
success
boolean

Indicates whether the request was successful

​
result
object[]

Party roles for the account (not paginated)