---
title: "List guides within a folder"
method: GET
path: "/folder/guide"
tags: ["folder"]
---

# List guides within a folder

`GET /folder/guide`

## Request

- Base URL: `https://public.stonly.com/api/v3`
- URL: `https://public.stonly.com/api/v3/folder/guide`
- Auth: HTTP basic

Retrieves a paginated list of guides residing in a specific folder.

## Query parameters

- `teamId` integer
- `folderId` integer, required
- `page` integer, required
- `limit` integer, required
- `guideStatus` 'draft' | 'published' | 'unpublished'
- `names` string[]
- `tags` string[]
- `updatedDateFrom` string, date
- `updatedDateTo` string, date
- `publishedDateFrom` string, date
- `publishedDateTo` string, date
- `recursive` boolean

## Response `200`

Guide list retrieved successfully.

- object
  - `items` GuideItem[]: List of guides in the current page.
    - `entityId` string: Guide ID
    - `entityName` string
    - `entityStatus` 'draft' | 'published' | 'unpublished'
    - `entityLanguages` SupportedLanguages[]
    - `entityFolder` object
      - `id` integer
      - `name` string
  - `itemsCounter` integer: Total number of items available.
  - `existsNext` boolean: True if more pages of results are available.

## Other responses

- `default`: Standard error response.

---

[API](https://skmtc.dev/stonly/apis/stonly-public-api.md) - [All operations](https://skmtc.dev/stonly/apis/stonly-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/stonly/apis/stonly-public-api/revisions/4ba5b03a634a?raw)