Skip to main content
Metadata instances can be listed for either a file or a folder.

​
List metadata on a file

To list all metadata instances on a file, call the GET /files/:file_id/metadata API endpoint. 
curl -i -X GET "https://api.box.com/2.0/files/12345/metadata" \
     -H "authorization: Bearer <ACCESS_TOKEN>"
This API does not support paging and it will always return all of the metadata instances for this file.

​
List metadata on a folder

To list all metadata instances on any folder (except for the root folder), call the GET /folders/:file_id/metadata API endpoint. 
curl -i -X GET "https://api.box.com/2.0/folders/4353455/metadata" \
     -H "authorization: Bearer <ACCESS_TOKEN>"
This API does not support paging and it will always return all of the metadata instances for this file. This API can not be used on the root folder with ID 0.