# Query the transactions list

[Choose a reporting strategy](https://devportal-simpay-sbx.winkpg.io/docs/decide/reporting-strategy.md): Whether to ask this platform for payment data on a schedule, or to have it sent to you as it happens, and what each one costs you to run.

Ask for the payments you want, when you want them, with the filters on the list endpoint.

**Your answers so far**

- What does your reporting need from each payment? Every payment on its own, with its own detail.
- How soon after a payment do you need it? A scheduled run is soon enough. Minutes or hours later is fine.
- How many payments a day are you reporting on? Tens or low hundreds a day.

**What to build**

Call the transactions list with the filters that describe your window, and page through the result. Run it on a schedule for a periodic load, or on demand when somebody opens a report. At this volume there is nothing a webhook receiver would buy you that a filtered request doesn't already give you, without an endpoint to deploy, secure, and keep available.

**Worth knowing**

- Filter on a closed window and page to the end of it. Paging is by continuation token, so follow the token rather than asking for a page number.
- A payment's state moves after it's created. Decide whether your load is reading new payments or re-reading recent ones for their current state, because a window that only looks at creation time never sees the second.
- Polling counts against your rate allowance like any other call. A tight loop over a quiet window spends it on responses that repeat the last one.

**Where to go next**

- [List transactions](https://devportal-simpay-sbx.winkpg.io/docs/api/transactionsGetList.md)
- [Transaction lifecycle and settlement](https://devportal-simpay-sbx.winkpg.io/docs/guides/transaction-lifecycle-and-settlement.md)
- [Rate limits and your allowance](https://devportal-simpay-sbx.winkpg.io/docs/guides/rate-limiting.md)
- [Getting started with the API](https://devportal-simpay-sbx.winkpg.io/docs/guides/api-getting-started.md)

- [Start over](https://devportal-simpay-sbx.winkpg.io/docs/decide/reporting-strategy.md): go back to the first question.

## See also

- [All documentation](https://devportal-simpay-sbx.winkpg.io/llms.txt): the machine-readable index of every public page on this site.