Skip to main content

GetAccountPermissions

Retrieves permissions assigned to a specific account.

Request

GET /nxt?requestType=get-account-permissions

All endpoints use port 22024 by default.

Parameters

NameTypeDescriptionRequired
accountstringAccount ID or SHAMWARI addressYes

Response

{
"permissions": [
{
"entity": "1234567890",
"entityRS": "SHAMWARI-ABCD-EFGH-IJKL-MNOPQ",
"entityType": "ACCOUNT",
"permissionBits": 8
}
]
}

Response Fields

FieldTypeDescription
entitystringEntity ID (account, contract, etc.)
entityRSstringEntity Reed-Solomon address in SHAMWARI format
entityTypestringEntity type (ACCOUNT, CONTRACT, etc.)
permissionBitsintPermission bitmask

Permission Bit Values

Bit ValuePermission
1OUTGOING_TRANSACTIONS_ALLOWED
2INCOMING_TRANSACTIONS_ALLOWED
4ASSET_ISSUANCE_ALLOWED
8CURRENCY_ISSUANCE_ALLOWED
16ACCOUNT_PROPERTY_SET_ALLOWED
32ACCOUNT_CONTROLLER_ALLOWED
64GRAYLISTING_ALLOWED

Error Codes

CodeDescription
3Unknown account

Example

curl "http://localhost:22024/nxt?requestType=get-account-permissions&account=SHAMWARI-ABCD-EFGH-IJKL-MNOPQ"