GET

List unspent reservation

Query reserved unspents in the wallet.

Path Params

walletId string required

The wallet ID.

matches ^[0-9a-f]{32}$

Query Params

prevId string

Return the next batch of results, based on the "nextBatchPrevId" value from the previous batch.
limit integer

Maximum number of results to return. If the result set is truncated, use the nextBatchPrevId value to get the next batch.

>= 1 · <= 500

Defaults to 25
expireTimeGt string date-time

Returns reserved unspents with an expireTime greater than this value.
expireTimeLte string date-time

Returns reserved unspents with an expireTime less than or equal to this value.
expireTime string

Returns reserved unspents with an expireTime equal to this value. If never, returns unspents without expiration dates.

Responses

200

Response Body

object

unspents array of objects
unspents object
- id string required
  
  The id of the unspent in the form :<tx_index>
- walletId string required
  
  matches ^[0-9a-f]{32}$
- expireTime string date-time required
- userId string required
  
  matches ^[0-9a-f]{32}$
nextBatchPrevId string

400

Bad Request

Response Body

object

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

curl --request GET \ --url 'https://app.bitgo-test.com/api/v2/wallet/walletId/reservedunspents&prevId=string?limit=25&expireTimeGt=string&expireTimeLte=string&expireTime=string' \ --header 'accept: application/json' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

const url = 'https://app.bitgo-test.com/api/v2/wallet/walletId/reservedunspents&prevId=string?limit=25&expireTimeGt=string&expireTimeLte=string&expireTime=string'; const options = {method: 'GET', headers: {accept: 'application/json', 'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}}; fetch(url, options) .then(res => res.json()) .then(json => console.log(json)) .catch(err => console.error(err));

require 'uri' require 'net/http' url = URI("https://app.bitgo-test.com/api/v2/wallet/walletId/reservedunspents&prevId=string?limit=25&expireTimeGt=string&expireTimeLte=string&expireTime=string") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["accept"] = 'application/json' request["Authorization"] = 'Bearer YOUR_ACCESS_TOKEN' response = http.request(request) puts response.read_body

<?php require_once('vendor/autoload.php'); $client = new \GuzzleHttp\Client(); $response = $client->request('GET', 'https://app.bitgo-test.com/api/v2/wallet/walletId/reservedunspents&prevId=string?limit=25&expireTimeGt=string&expireTimeLte=string&expireTime=string', [ 'headers' => [ 'accept' => 'application/json', 'Authorization' => 'Bearer YOUR_ACCESS_TOKEN', ], ]); echo $response->getBody();

import requests url = "https://app.bitgo-test.com/api/v2/wallet/walletId/reservedunspents&prevId=string?limit=25&expireTimeGt=string&expireTimeLte=string&expireTime=string" headers = { "accept": "application/json", "Authorization": "Bearer YOUR_ACCESS_TOKEN" } response = requests.get(url, headers=headers) print(response.text)

{ "unspents": [ { "id": "003f688cc349f1fca8ac5ffa21671ca911b6ef351085c60733ed8c2ebf162cb8:2", "walletId": "59cd72485007a239fb00282ed480da1f", "expireTime": "string", "userId": "59cd72485007a239fb00282ed480da1f" } ], "nextBatchPrevId": "string" }