Pagination & Filtering

List endpoints (like snapshot history) use page-based pagination.

Parameters

Parameter	Type	Description
`page`	integer	1-based page number. Default `1`.
`limit`	integer	Results per page. Default `100`, max `500`.

curl "https://snapshots.finopsbricks.com/api/v1/widgets/WIDGET_ID/snapshots?page=2&limit=50" \
  -H "api-key: <KEY>" -H "api-secret: <SECRET>"

Paginated responses wrap results in data and add a page_context:

{
  "data": [ /* … */ ],
  "page_context": {
    "count": 50,
    "page": 2,
    "per_page": 50,
    "total": 143,
    "has_more": true
  }
}

count is the number of items on this page; total is across all pages. Keep incrementing page while has_more is true.