List folders
Returns the folders in your organisation, by name. Pass parent to list the folders directly inside one folder, or parent=none for those at the top level; leave it out to list every folder. Narrow any of these with type. An API key sees every folder, restricted ones included. An OAuth caller sees the folders their role and permissions allow. Pages by cursor: pass each response’s next_cursor as cursor until it is null.
ApiKeyAuthorizationBearer <token>Your organisation's API key. Send it as Authorization: Bearer <key>. Create one in the Scannable admin under Settings → API keys.
limit?integerPage size (1–100). Defaults to 20.
1 <= value <= 10020cursor?stringThe next_cursor of the previous page. Leave it out for the first page. A cursor only works with the filters it was issued for.
type?stringOnly folders of this type.
"default""kit_bag""location""vehicle""client""equipment_type""staff"parent?stringOnly the folders directly inside this one, as a folder_… identifier, or none for the folders at the top level. Leave it out to list every folder. A folder of another organisation returns 404.
A page of your folders, by name.
application/json- response
data*array<>total*integerThe total number of results that match the filters.
-9007199254740991 <= value <= 9007199254740991limit*integerThe page size applied to this response.
-9007199254740991 <= value <= 9007199254740991next_cursor*|Pass as cursor to fetch the next page. Null on the last page.
curl -X GET 'https://api.scannable.io/v1/folders'{ "data": [ { "id": "folder_z7n9dlj7vy13rpj", "name": "Van 3", "type": "vehicle", "parent": { "id": "folder_zeoaiw6e0bc95bl", "name": "Queenstown Depot" }, "restricted": false, "created_at": "2026-03-02T09:30:00.000Z" } ], "total": 42, "limit": 20, "next_cursor": "eyJwb3NpdGlvbiI6eyJjcmVhdGVkQXQiOiIyMDIxLTAyLTI1VDIzOjIzOjI5LjAwMFoiLCJ1aWQiOiJpdXNoOTN4djN4cnN2MWMifSwiZmlsdGVycyI6Imw5Rnc0VlVPN2tyOCJ9"}List the members of a team GET
Returns the members of a team in your organisation, by last name and then first name. Pass each response’s `next_cursor` as `cursor` to fetch the next page, until it is null.
Retrieve a folder GET
Returns one folder in your organisation, with the members and teams that have a permission on it. An API key can read a restricted folder. An OAuth caller can read it only with access to it.