Skip to main content

GetAccountLessors

Retrieves lessors for a specific account - accounts that have leased balance from this account.

Request

GET /nxt?requestType=get-account-lessors

All endpoints use port 22024 by default.

Parameters

NameTypeDescriptionRequired
accountstringAccount ID or SHAMWARI addressYes
heightintBlock height for historical queryOptional

Response

{
"lessors": [
{
"account": "1234567890",
"accountRS": "SHAMWARI-ABCD-EFGH-IJKL-MNOPQ",
"height": 250,
"balanceNQT": "1000000000"
}
]
}

Response Fields

FieldTypeDescription
accountstringLessor account ID
accountRSstringLessor account Reed-Solomon address in SHAMWARI format
heightintBlock height when lease was established
balanceNQTstringAmount leased in NQT

Error Codes

CodeDescription
3Unknown account

Example

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