# lookupAssetBalances

GET

/v2/assets/{asset-id}/balances

Lookup the list of accounts who hold this asset

## Parameters

### Path Parameters

**asset-id**  
required  
integer

### Query Parameters

**include-all**  
boolean  
Include all items including closed accounts, deleted applications, destroyed assets, opted-out asset holdings, and closed-out application localstates.

**limit**  
integer  
Maximum number of results to return. There could be additional pages even if the limit is not reached.

**next**  
string  
The next page of results. Use the next token provided by the previous results.

**currency-greater-than**  
integer  
Results should have an amount greater than this value. MicroAlgos are the default currency unless an asset-id is provided, in which case the asset will be used.

**currency-less-than**  
integer  
Results should have an amount less than this value. MicroAlgos are the default currency unless an asset-id is provided, in which case the asset will be used.

## Responses

### 200

(empty)

Select media type application/json

object

**balances**  
required  
Array<object>

A simplified version of AssetHolding

object

**address**  
required  
string

**amount**  
required  
integer

**deleted**  
Whether or not this asset holding is currently deleted from its account.

boolean

**is-frozen**  
required  
boolean

**opted-in-at-round**  
Round during which the account opted into the asset.

integer

**opted-out-at-round**  
Round during which the account opted out of the asset.

integer

**current-round**  
required  
Round at which the results were computed.

integer

**next-token**  
Used for pagination, when making another request provide this token with the next parameter.

string

### 400

Response for errors

Select media type application/json

object

**data**  
object

**message**  
required  
string

### 500

Response for errors

Select media type application/json

object

**data**  
object

**message**  
required  
string