Ctrl+K

List unspent reservation

get/api/v2/wallet/{walletId}/reservedunspents

Query reserved unspents in the wallet.

Path Parameters

  • walletIdstringRequired
    Example: 59cd72485007a239fb00282ed480da1f
    Pattern: ^[0-9a-f]{32}$

Query Parameters

  • prevIdstring
    Return the next batch of results, based on the "nextBatchPrevId" value from the previous batch.
  • limitintegerDefault: 25
    Maximum number of results to return. If the result set is truncated, use the 'nextBatchPrevId' value to get the next batch.
    Minimum: >= 1
    Maximum: <= 500
  • expireTimeGtstring<date-time>
    Returns reserved unspents with an 'expireTime' greater than this value.
  • expireTimeLtestring<date-time>
    Returns reserved unspents with an 'expireTime' less than or equal to this value.
  • expireTimestring
    Returns reserved unspents with an 'expireTime' equal to this value. If 'never', returns unspents without expiration dates.

200 Response

unspents array[object]
a ReservedUnspent object
id string required
The id of the unspent in the form <txid>:<tx_index>
Example: 003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8:2
walletId string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
expireTime string <date-time>required
userId string required
Example: 59cd72485007a239fb00282ed480da1f
Match pattern: ^[0-9a-f]{32}$
nextBatchPrevId string

400 Response

error string required
Human-readable error message
requestId string required
Client request id
context object
Properties that apply to a specific error name
name string required
Error code