> For the complete documentation index, see [llms.txt](https://docs.altura.com/altura-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.altura.com/altura-documentation/js-sdk-reference/get-methods/get-an-items-holders.md).

# Get an Item's Holders

Use this method to get the holders of items. 

### Usage in your script

{% tabs %}
{% tab title="JavaScript" %}

```javascript
const response = await alturaItem.getHolders();

// customize options
const response = await alturaItem.getHolders({
  perPage: 20,
  page: 1,
  includeListed: false
});

const holders = response.holders;
```

{% endtab %}

{% tab title="TypeScript" %}

```typescript
const response: {holders: IAlturaUser[]} = await alturaItem.getHolders();

// customize options
const response: {holders: IAlturaUser[]} = await alturaItem.getHolders({
  perPage: 20,
  page: 1,
  includeListed: false
});

const holders = response.holders;
```

{% endtab %}
{% endtabs %}

### **Parameters**

<table><thead><tr><th width="193.33333333333331">Parameter</th><th width="122">Type</th><th width="109">Required</th><th>Description</th></tr></thead><tbody><tr><td>perPage</td><td>number</td><td><strong>Optional</strong></td><td>The number of users to return</td></tr><tr><td>page</td><td>number</td><td><strong>Optional</strong></td><td>The offset for returned items. Calculated as (page - 1) * perPage</td></tr><tr><td>includeListed</td><td></td><td><strong>Optional</strong></td><td>If user's who have their item listed should be included (listed NFTs are still owned by the user, however on the blockchain they are held by a marketplace smart contract)boolean</td></tr></tbody></table>