GetAccountProperties
Retrieves properties set on a specific account, optionally filtered by property name, setter, or recipient.
Request
GET /nxt?requestType=get-account-properties
All endpoints use port 22024 by default.
Parameters
| Name | Type | Description | Required |
|---|---|---|---|
account | string | Account ID or SHAMWARI address | Optional |
recipient | string | Filter by recipient account | Optional |
property | string | Filter by property name | Optional |
setter | string | Filter by setter account | Optional |
firstIndex | int | Pagination start index | Optional |
lastIndex | int | Pagination end index | Optional |
Response
{
"properties": [
{
"property": "my_property",
"value": "my_value",
"setter": "1234567890",
"setterRS": "SHAMWARI-WXYZ-ABCD-EFGH-IJKLM",
"recipient": "0987654321",
"recipientRS": "SHAMWARI-MNOP-QRST-UVWX-YZABC",
"height": 250
}
]
}
Response Fields
| Field | Type | Description |
|---|---|---|
property | string | Property name |
value | string | Property value |
setter | string | Account ID that set the property |
setterRS | string | Setter's SHAMWARI address |
recipient | string | Account ID the property is set for |
recipientRS | string | Recipient's SHAMWARI address |
height | int | Block height when property was set |
Error Codes
| Code | Description |
|---|---|
| 3 | Unknown account |
Example
curl "http://localhost:22024/nxt?requestType=get-account-properties&account=SHAMWARI-ABCD-EFGH-IJKL-MNOPQ"