# getRailsForPayerAndToken

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

Defined in: [packages/synapse-core/src/pay/get-rails-for-payer-and-token.ts:82](https://github.com/FilOzone/synapse-sdk/blob/aaa98045b003ec23f4318ba9a3032a434e5a20c9/packages/synapse-core/src/pay/get-rails-for-payer-and-token.ts#L82)

Get one bounded page of rails for a payer and token.

Pass the returned `nextCursor` back as `cursor`; treat it as opaque. Use
[paginate](/reference/filoz/synapse-core/core/functions/paginate/) to traverse every page. `total` is the contract's underlying
rail-slot count, including slots skipped because their rails were finalized.

## Parameters

| Parameter | Type | Description |
| ------ | ------ | ------ |
| `client` | `Client`\<`Transport`, `Chain`\> | The client to use to get the rails. |
| `options` | [`OptionsType`](/reference/filoz/synapse-core/pay/namespaces/getrailsforpayerandtoken/type-aliases/optionstype/) | [getRailsForPayerAndToken.OptionsType](/reference/filoz/synapse-core/pay/namespaces/getrailsforpayerandtoken/type-aliases/optionstype/) |

## Returns

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

Paginated rail results [getRailsForPayerAndToken.OutputType](/reference/filoz/synapse-core/pay/namespaces/getrailsforpayerandtoken/type-aliases/outputtype/)

## Throws

Errors [getRailsForPayerAndToken.ErrorType](/reference/filoz/synapse-core/pay/namespaces/getrailsforpayerandtoken/type-aliases/errortype/)

## Examples

**Read the first page**

```ts
import { getRailsForPayerAndToken } from '@filoz/synapse-core/pay'
import { createPublicClient, http } from 'viem'
import { calibration } from '@filoz/synapse-core/chains'

const client = createPublicClient({
  chain: calibration,
  transport: http(),
})

const payer = '0x1234567890123456789012345678901234567890'
const page = await getRailsForPayerAndToken(client, { payer })
console.log(page.items, page.nextCursor, page.total)
```

**Iterate over every page**

```ts
import { paginate } from '@filoz/synapse-core'
import { getRailsForPayerAndToken } from '@filoz/synapse-core/pay'

for await (const rail of paginate(({ cursor }) =>
  getRailsForPayerAndToken(client, { payer, cursor })
)) {
  console.log(`Rail ${rail.railId}: ${rail.isTerminated ? 'Terminated' : 'Active'}`)
}
```