---
title: "Get folders (by parent)"
method: GET
path: "/directory/v1/parent/{id}/folders"
tags: ["Directory (Sites)"]
---

# Get folders (by parent)

`GET /directory/v1/parent/{id}/folders`

## Path parameters

- `id` string, required

## Query parameters

- `include_members_count` boolean
- `limit` integer
- `page_token` string
- `include_inherited_members_count` boolean
- `domain` string
- `only_assigned_folders` boolean
- `with_deleted_folders` boolean

## Response `200`

A successful response.

- S12DirectoryV1GetFoldersByParentResponse — Result returned from `GetFoldersByParentResponse`
  - `folders` S12DirectoryV1FolderWithMembersCount[] — List of children folders with a count of their explicitly associated members When `include_members_count` is set to false `members_count` in `FolderWithMembersCount` is always set to the default zero value
    - `folder` S12DirectoryV1Folder — Folder represents the main directory object
      - `id` string — An unique identifier for the folder. Must be a valid UUID. For example: '00001d65-d336-485a-8331-7b53f37e8f51'
      - `name` string — Name associated with folder
      - `org_id` string — The organisation that the folder belongs to
      - `creator_id` string — The user id responsible for creating the folder For example: 'user_5441fffcde344415bb7ccaceda27e196'
      - `created_at` string, date-time — The creation timestamp of the folder (Date, Time, Timezone) For example: '2020-04-28T04:14:31:00Z'
      - `modified_at` string, date-time — The timestamp of the last modification for the folder (Date, Time, Timezone) For example: '2020-04-28T04:14:00Z'
      - `meta_label` string — Additional meta information that can be associated with the folder e.g. 'location'
      - `members_count` integer — The number of users with a direct association of type 'MEMBER' for the folder
      - `deleted` boolean — Whether a folder has been marked as deleted or not.
    - `members_count` integer — The number of users with a direct association of type 'MEMBER' for the folder
    - `has_children` boolean — Whether or not a folder has children.
    - `inherited_members_count` integer — The number of users with an inherited association of type 'MEMBER' for the folder
    - `depth` integer — The depth of the folder. 0 being a top level folder with no parents
    - `children_count` integer — The count of children folders
  - `next_page_token` string — Optional. base64 encoded. If this field is present, the value should be used in subsequent calls to GetFoldersByParent to get the next page of results. Otherwise, no further calls should be made.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/safetyculture/apis/safetyculture-api.md) · [All operations](https://skmtc.net/safetyculture/apis/safetyculture-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/safetyculture/safetyculture-api/revisions/5be91df61ded/schema)