Skip to main content
GET
Gets a role by ID.

Authorizations

Authorization
string
header
required

Application (M2M) OAuth2 access token (client credentials).

Headers

X-Organization-ID
string<uuid>

ID of the organization to scope this operation to. When omitted, the role is looked up in the caller's own organization. Must be a valid non-empty UUID. Present but empty or malformed values return 400.

Path Parameters

roleId
string<uuid>
required

The ID of the role.

Response

Returns the role.

id
string<uuid>
required
createdDateTime
string<date-time>
required
key
required
Available options:
bank:admin,
embedded:admin,
embedded:bookkeeper,
embedded:employee,
embedded:finance_admin,
platform:admin,
vsp:admin
name
string
required
sortOrdinal
required
status
string
required
updatedDateTime
string<date-time>
required
appliesToOrgType
null | string
description
null | string
icon
null | string
isSystemRole
boolean
organizationId
null | string<uuid>