Hey Gordon,
First, you can get a full list of the iControl REST API on a given [xyz] namespace, by calling:
https://device/mgmt/tm/xyz
So, for example, on the "/" namespace you would call:
https://device/mgmt/tm/
or, for the auth/ namespace:
http://device/mgmt/tm/auth/
(This way at least you can have an idea of the available REST API within a namespace).
Regarding your question, the following API:
https://device/mgmt/tm/sys/folder
would give you a full list of the available [folder] partitions (as a JSON array), then if you need details on any of them, e.g. "Common", you would call:
https://device/mgmt/tm/sys/folder/~Common/
And you should get a similar response with:
{
"kind": "tm:sys:folder:folderstate",
"name": "Common",
"subPath": "/",
"fullPath": "/Common",
"generation": 1,
"selfLink": "https://localhost/mgmt/tm/sys/folder/~Common?ver=11.5.0",
"deviceGroup": "none",
"hidden": "false",
"inheritedDevicegroup": "true",
"inheritedTrafficGroup": "true",
"noRefCheck": "false",
"trafficGroup": "/Common/traffic-group-1"
}
I'm not sure if this answers your question, but please post back if you're looking for a different information.