What is the limit parameter used for in List_ v3 API calls?

In the Recurly v3 API, the limit parameter impacts the number of results that are returned per API request. This is due to a Pager class that will continue to make API requests until the entire record set is exhausted.

For example, let's assume that there are a total of 100 Subscriptions in total. If you specify a limit of 100 then there will be a single ListSubscriptions() API request that returns all 100 records. However, if you specify a limit of 50, then there will be 2 API requests required to consume all of the records.

In the Recurly v2 API, the limit parameter was named per_page.  For more information, please check out our knowledge base article on Pagination using the v3 API.