---
title: "Retrieve a folder"
method: GET
path: "/directory/v1/folder/{id}"
tags: ["Directory (Sites)"]
---

# Retrieve a folder

`GET /directory/v1/folder/{id}`

## Path parameters

- `id` string, required

## Query parameters

- `with_ancestors` boolean
- `with_all_children_count` boolean

## Response `200`

A successful response.

- S12DirectoryV1GetFolderResponse — Result returned from `GetFolderResponse`
  - `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.
  - `ancestors` S12DirectoryV1Folder[] — When with_ancestors is true, an array of the folders ancestors will be returned. The array will be ordered, closest ancestor to furthest
    - `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.
  - `all_children_count` integer — The total count of children underneath the folder. I Including children of children recursively
  - `member_count` integer — The number of users with a direct association of type 'MEMBER' for the folder
  - `deleted` boolean — Whether the folder is deleted or not

## 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)