Skip to main content

Pagination

A listing returns one page per call. With --page-all the CLI walks through the pages and prints one record per line, in NDJSON:

kobana billing invoices list --page-all --fields "id,status,total"

Each line is a complete JSON object, so the output can be processed as it arrives:

kobana kadu executions list --page-all | jq -r 'select(.status == "failed") | .id'

How it paginates​

  • If the endpoint declares a cursor parameter, the CLI follows meta.next_cursor.
  • Otherwise, it uses page and per_page.

Limits​

FlagDefaultWhat for
--page-limit <N>10Maximum number of pages fetched
--page-delay <MS>100Interval between pages, in milliseconds

Raise --page-limit on purpose: it exists so that a huge listing does not turn into thousands of calls without you noticing.

kobana banking charge pix list --page-all --page-limit 50 --page-delay 250