---
title: "Retrieves a folder."
method: GET
path: "/crm/v3/lists/folders"
tags: ["Basic"]
---

# Retrieves a folder.

`GET /crm/v3/lists/folders`

Retrieves a folder and recursively includes all folders via the childNodes attribute.  The child lists field will be empty in all child nodes. Only the folder retrieved will include the child lists in that folder.

## Query parameters

- `folderId` string

## Response `200`

successful operation

- ListFolderFetchResponse
  - `folder` PublicListFolder, required
    - `childLists` integer[], required — An array of list Id's contained in this folder.
    - `childNodes` PublicListFolder[], required
    - `createdAt` string, date-time — The time the folder was created at.
    - `id` string, required — The Id of the folder.
    - `name` string — The name of the folder.
    - `parentFolderId` string, required — The Id of the folder this folder is in, the root folder is represented as 0.
    - `updatedAt` string, date-time — The time the folder was last updated at.
    - `updatedContentsAt` string, date-time — The time that the contents of the folder was last updated at.
    - `userId` integer — The user Id of the owner of the folder.

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/hubspot/apis/crm-lists.md) · [All operations](https://skmtc.net/hubspot/apis/crm-lists/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/crm-lists/revisions/2ba1203b03a0/schema)