List Files
List drive files (offset pagination, #9317 contract; true total).
EXACTLY the view the app’s file browser presents, via the browser’s own
predicates (FolderService.get_folder_contents / get_root_contents
file conditions verbatim): library-visible files only
(show_in_library), the shared FileAccessChecker visibility filter
(another user’s private file is invisible), newest-modified first with the
id tiebreaker that keeps pages stable. Folder-scoped listings resolve the
folder with the app’s rules first: cross-team and other users’ private
folders are indistinguishable 404s, and hidden system subtrees (brand-kit
/.canvas-data machinery) are blocked exactly like folder navigation.
The unscoped listing covers the same locations the tree exposes — files
inside folders you cannot see stay invisible even when team-visible.
Authorizations
API key from Settings > Developer > REST API
Headers
Calendar-dated API version pin. New integrations should pin 2026-05-01 to opt into the newest response shapes. For back-compat the server also accepts requests with no header and resolves them to the current default (today: 2026-04-12); that default advances on each sunset date. Any unsupported value returns 400 unsupported_version.
2026-04-12, 2026-05-01 "2026-05-01"
Query Parameters
Filter to one location: a folder id (fld_...) for that folder's files, or the literal root for unfiled files. Omit to list every library-visible file across the locations you can see.
Max files per page. Defaults to 50, caps at 200.
1 <= x <= 200Files to skip — pass offset + limit to page through.
x >= 0Response
Successful Response
The response is of type Response Drivelistfiles · object.