nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

Child Item

Page size for /list_folder api

Harish P.2

Hello Team,

I have a query on the page size of the following api:

/list_folder

It is learnt from the documentation that, the following response attribute is true, if there are more entries / contents in a specified folder.

"has_more": true

I would like to know the maximum number of entries that would be shown in the first /list_folder call, and what would be the page size of subsequent calls for /list_folder/continue.

Any inputs on this would greatly help. Thanks in advance.

Regards,
Harish

Find more posts tagged with

API

Abuse

Comments

Steve M.

I don't think the API makes any guarantees about the size of these payloads. I believe that in practice I tend to see results sets on the order of thousands of entries per call.

Why do you ask? Hopefully your code can handle any reasonable result size.

Itai M.

Hi Steve,

Please define "reasonable" - the size of the result affects the performance of the application. In our code we pass on the list of files for further processing by other parts of the application which have their own size and rate limits, so we need to make sure that we are handling the load properly - and we cannot do that unless we know the maximum size.

Every other API I have used provides a default page size, while also allowing the caller to override it as needed.

So it seems to me this is a straightforward feature request, and it would be great if you guys could add it to one of the upcoming API versions.

Thanks!

Effi (from Itai's team at Kenshoo.com)

Greg-DB

We don't currently document or guarantee a maximum possible page size for /list_folder, but if I recall correctly, you will generally see 1-2 thousand entries per page.

I've sent this along as requests for a documented maximum, as well as the ability to set custom page sizes.

Greg-DB

I just wanted to follow up here to let you know that you can now set an approximate limit on the list_folder page size using the "limit" parameter:

https://www.dropbox.com/developers/documentation/http/documentation#files-list_folder

Hope this helps!