limit and return 10 rows when you omit it. There are four shapes, and a missing pagination object reads as “no more results”.
Read the shape off the response, not off the resource. The table at the end says which endpoint uses which.
The four shapes
The rows always come back under a key named for the resource —data, payouts, recipients. What changes is what sits beside them.
An offset object
Takeslimit and offset, and wraps the rows with a pagination object.
limit to offset until has_more is false. total counts the rows matching your filters, not the rows on this page.
Numbered pages
Takeslimit and page, counting from 1, and puts the counters at the top level beside the rows.
has_more here. Stop when page reaches total_pages.
A bare array
Takeslimit and offset and returns the rows with nothing around them:
has_more. You have reached the end when you get back fewer rows than the limit you asked for.
A total with no paging
Returns every row and atotal, and takes no limit, offset or page. Sending one changes nothing.