> 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-items.md).

# Get Items

Use this method to get metadata of multiple Items at the same time. 

### Usage in your script

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

```javascript
const response = await altura.getItems();

// customize options
const response = await altura.getItems({
  perPage: 20,
  page: 1,
  sortBy: 'name',
  sortDir: 'asc',
  slim: true,
});

// filter documents by any properties
const response = await altura.getItems(
  {}, // default options
  {
    collectionAddress: "0x78e99615063da7c12c247e6bc01240da00df77ae"
  } // fetching items with the specified collection address only
)

const items = response.items;
const itemCount = response.count;
```

{% endtab %}

{% tab title="TypeScript" %}

```typescript
const response: { items: IAlturaItem[], count: number } = await altura.getItems();

// customize options
const response: { items: IAlturaItem[], count: number } = await altura.getItems({
  perPage: 20,
  page: 1,
  sortBy: 'name',
  sortDir: 'asc',
  slim: true,
  stateOnly: true
});

// filter documents by any properties
const response: { items: IAlturaItem[], count: number } = await altura.getItems(
  {}, // default options
  {
    collectionAddress: "0x78e99615063da7c12c247e6bc01240da00df77ae"
  } // fetching items with the specified collection address only
)

const items = response.items;
const itemCount = response.count;
```

{% endtab %}
{% endtabs %}

### **Parameters**

<table><thead><tr><th width="193.33333333333331">Parameter</th><th width="103">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 items 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>sortBy</td><td>string</td><td><strong>Optional</strong></td><td>The field to sort the items by (any field in the item schema may be used)</td></tr><tr><td>sortDir</td><td>'asc' | 'desc'</td><td><strong>Optional</strong></td><td>Choose to sort in ascending (asc) or descending (desc) order</td></tr><tr><td>slim</td><td>boolean</td><td><strong>Optional</strong></td><td>Returns a more condensed version of the items. Limits the item schema to: name, properties, tokenId, collectionAddress, supply, maxSupply, image, imageUrl, imageIndex, and imageCount</td></tr></tbody></table>