---
title: "Retrieve folders"
method: POST
path: "/cms/pages/2026-03/landing-pages/folders/batch/read"
tags: ["Folders"]
---

# Retrieve folders

`POST /cms/pages/2026-03/landing-pages/folders/batch/read`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/cms/pages/2026-03/landing-pages/folders/batch/read`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `cms.pages.landing_pages.read`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `content`

Retrieve a batch of landing page folders as identified in the request body.

## Query parameters

- `archived` boolean

## Request body

- BatchInputString
  - `inputs` string[], required: Strings to input.

## Response `200`

successful operation

- BatchResponseContentFolder
  - `completedAt` string, date-time, required: Time of batch operation completion.
  - `links` object: Links associated with batch operation.
  - `requestedAt` string, date-time: Time of batch operation request.
  - `results` ContentFolder[], required: Results of batch operation.
    - `category` integer, required: The type of object this folder applies to. Should always be LANDING_PAGE.
    - `created` string, date-time, required: The timestamp indicating when the content folder was created.
    - `deletedAt` string, date-time, required: The timestamp (ISO8601 format) when this content folder was deleted.
    - `id` string, required: The unique ID of the content folder.
    - `name` string, required: The name of the folder which will show up in the app dashboard
    - `parentFolderId` integer, required: The ID of the content folder this folder is nested under
    - `updated` string, date-time, required: The timestamp indicating when the content folder was last updated.
  - `startedAt` string, date-time, required: Time of batch operation start.
  - `status` 'CANCELED' | 'COMPLETE' | 'PENDING' | 'PROCESSING', required: Status of batch operation.

## Other responses

- `207`: multiple statuses
- `default`: An error occurred.

## Changes

- **2026-11-03** (2026-03) `b4815293e3e1`: 1 breaking, 3 info
  - removed the media type `*/*` from the request body
  - the security scope `cms.pages.landing_pages.read` was added to the endpoint's security scheme `oauth2`
  - the security scope `content` was removed from the endpoint's security scheme `oauth2`
  - added the media type `application/json` to the request body
- **2026-11-02** (2026-03) `66af5bb9e956`: 2 info
  - the security scope `cms.pages.landing_pages.read` was added to the endpoint's security scheme `oauth2`
  - the security scope `content` was removed from the endpoint's security scheme `oauth2`
- **2026-09-21** (2026-03) `cc9e206c2481`: 2 info
  - the security scope `content` was added to the endpoint's security scheme `oauth2`
  - the security scope `landingpages-read` was removed from the endpoint's security scheme `oauth2`
- **2026-09-10** (2026-03) `1a3751fa5a49`: 2 info
  - the security scope `content` was added to the endpoint's security scheme `oauth2`
  - the security scope `content.landing_pages.read` was removed from the endpoint's security scheme `oauth2`
- **2026-09-09** (2026-03) `19f59a3ef408`: 2 info
  - the security scope `content` was added to the endpoint's security scheme `oauth2`
  - the security scope `content.landing_pages.read` was removed from the endpoint's security scheme `oauth2`

[Operation history](https://skmtc.dev/hubspot/apis/cms-pages/changes/cms/pages/2026-03/landing-pages/folders/batch/read/post.md)

---

[API](https://skmtc.dev/hubspot/apis/cms-pages.md) - [All operations](https://skmtc.dev/hubspot/apis/cms-pages/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/cms-pages/revisions/b4815293e3e1?raw)