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

# Retrieve a folder

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

## Request

- Base URL: `https://api.mitti.com`
- URL: `https://api.mitti.com/directory/v1/folder/{id}`
- Auth: HTTP bearer

## 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.dev/safetyculture/apis/safetyculture-api.md) - [All operations](https://skmtc.dev/safetyculture/apis/safetyculture-api/llms.txt) - [OpenAPI document](https://skmtc.dev/safetyculture/apis/safetyculture-api/revisions/eb6bb843bf18?raw)
