FinWise API
SupportChangelog

Pagination

List endpoints (HTTP GET) accept a pagination query parameter: a JSON object with pageNumber and pageSize. Defaults are page 1 and 100 items.

The payload is a JSON array. Pagination metadata is returned as headers, not in the body:

  • x-count — total matching rows
  • x-page-number / x-page-size
  • x-has-next-page — true or false

Query parameters

paginationobject
Page to fetch. Encode as a JSON string on the query.
pageNumbernumber
1-based page. Defaults to 1.
pageSizenumber
Items per page. Defaults to 100.
filtersnullable object
Resource-specific filters, also encoded as a JSON string.
GET/transactions?pagination={"pageNumber":1,"pageSize":100}
curl https://api.finwiseapp.io/transactions?pagination={"pageNumber":1,"pageSize":100} \
  -X GET \
  -H "Authorization: Bearer fw_..." \
  -H "Content-Type: application/json"
const response = await fetch('https://api.finwiseapp.io/transactions?pagination={"pageNumber":1,"pageSize":100}', {
  method: 'GET',
  headers: {
    Authorization: 'Bearer fw_...',
    'Content-Type': 'application/json',
  },
})
const data = await response.json()
Response
[
  {
    "id": "…",
    "description": "Walmart"
  }
]