# getActivePiecesByCursor

> **getActivePiecesByCursor**(`client`, `options`): [`Promise`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<[`OutputType`](/reference/filoz/synapse-core/pdp-verifier/namespaces/getactivepiecesbycursor/type-aliases/outputtype/)\>

Defined in: [packages/synapse-core/src/pdp-verifier/get-active-pieces-by-cursor.ts:69](https://github.com/FilOzone/synapse-sdk/blob/e6fb33f57d00c5c775ea37a127e65446e2eee635/packages/synapse-core/src/pdp-verifier/get-active-pieces-by-cursor.ts#L69)

Get one bounded page of active pieces using efficient piece-ID cursors.

The cursor is a piece ID, but callers should still treat `nextCursor` as
opaque and pass it back unchanged. Use [paginate](/reference/filoz/synapse-core/core/functions/paginate/) to traverse every
page, including sparse piece-ID ranges.

## Parameters

| Parameter | Type | Description |
| ------ | ------ | ------ |
| `client` | `Client`\<`Transport`, `Chain`\> | Client used to read the PDP Verifier. |
| `options` | [`OptionsType`](/reference/filoz/synapse-core/pdp-verifier/namespaces/getactivepiecesbycursor/type-aliases/optionstype/) | [getActivePiecesByCursor.OptionsType](/reference/filoz/synapse-core/pdp-verifier/namespaces/getactivepiecesbycursor/type-aliases/optionstype/) |

## Returns

[`Promise`](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise)\<[`OutputType`](/reference/filoz/synapse-core/pdp-verifier/namespaces/getactivepiecesbycursor/type-aliases/outputtype/)\>

A page of active pieces [getActivePiecesByCursor.OutputType](/reference/filoz/synapse-core/pdp-verifier/namespaces/getactivepiecesbycursor/type-aliases/outputtype/)

## Throws

Errors [getActivePiecesByCursor.ErrorType](/reference/filoz/synapse-core/pdp-verifier/namespaces/getactivepiecesbycursor/type-aliases/errortype/)

## Examples

**Read the first page**

```ts
import { getActivePiecesByCursor } from '@filoz/synapse-core/pdp-verifier'

const page = await getActivePiecesByCursor(client, { dataSetId: 1n })
console.log(page.items, page.nextCursor)
```

**Iterate over every page**

```ts
import { paginate } from '@filoz/synapse-core'
import { getActivePiecesByCursor } from '@filoz/synapse-core/pdp-verifier'

for await (const piece of paginate(({ cursor }) =>
  getActivePiecesByCursor(client, { dataSetId: 1n, cursor })
)) {
  console.log(piece.id, piece.cid)
}
```