GetAccountPermissions
Retrieves permissions assigned to a specific account.
Request
GET /nxt?requestType=get-account-permissions
All endpoints use port 22024 by default.
Parameters
| Name | Type | Description | Required |
|---|---|---|---|
account | string | Account ID or SHAMWARI address | Yes |
Response
{
"permissions": [
{
"entity": "1234567890",
"entityRS": "SHAMWARI-ABCD-EFGH-IJKL-MNOPQ",
"entityType": "ACCOUNT",
"permissionBits": 8
}
]
}
Response Fields
| Field | Type | Description |
|---|---|---|
entity | string | Entity ID (account, contract, etc.) |
entityRS | string | Entity Reed-Solomon address in SHAMWARI format |
entityType | string | Entity type (ACCOUNT, CONTRACT, etc.) |
permissionBits | int | Permission bitmask |
Permission Bit Values
| Bit Value | Permission |
|---|---|
| 1 | OUTGOING_TRANSACTIONS_ALLOWED |
| 2 | INCOMING_TRANSACTIONS_ALLOWED |
| 4 | ASSET_ISSUANCE_ALLOWED |
| 8 | CURRENCY_ISSUANCE_ALLOWED |
| 16 | ACCOUNT_PROPERTY_SET_ALLOWED |
| 32 | ACCOUNT_CONTROLLER_ALLOWED |
| 64 | GRAYLISTING_ALLOWED |
Error Codes
| Code | Description |
|---|---|
| 3 | Unknown account |
Example
curl "http://localhost:22024/nxt?requestType=get-account-permissions&account=SHAMWARI-ABCD-EFGH-IJKL-MNOPQ"