Skip to main content

How to get information about the current API user

Overview​

Use User API to get information about the current API user, available accounts, and account permissions.

This method is useful when you need to understand which accounts can be used by the current API key.

Request​

Use [POST] user/current.

FieldTypeRequiredDescription
timestampnumberYesCurrent Unix UTC timestamp in milliseconds. The value must not be less than 3 minutes in the past or greater than 3 minutes in the future.

Request example​

{
"timestamp": 1761650432438
}

Response fields​

FieldTypeDescription
userFullInfoobjectCurrent API user details.
permissionsarrayPermission groups by account.
availableAccountsarrayAccounts available to the user.

userFullInfo fields​

FieldTypeDescription
idstringUser ID.
usernamestringUsername.
companyIdstringCompany ID.
companyNamestringCompany name.
activebooleanShows whether the user is active.
blockedbooleanShows whether the user is blocked.
rolesarrayUser roles.

availableAccounts fields​

FieldTypeDescription
accountstringAccount ID.
namestringAccount name.

permissions fields​

FieldTypeDescription
accountIdstringAccount ID.
accountNamestringAccount name.
permissionGroupsarrayPermission groups assigned to the user for the account.
CaseRecommendation
API key is used by several accountsUse availableAccounts to choose a valid account value for account-scoped requests.
User cannot access account dataCheck permissions and account availability before creating payment, payout, or report requests.
Access should be displayed in UIShow only accounts returned in availableAccounts.
DocumentLink
Account balancesHow to get balances for a specific account
User API referenceUser API