---
title: "List immediate subfolders"
method: GET
path: "/container/subfolders"
tags: ["Raw Search"]
---

# List immediate subfolders

`GET /container/subfolders`

Aggregate the immediate subfolders located under the provided prefix.

Pagination is `page`/`page_size`. The server hides any cursor and handles deep paging internally.

Uniform response: { items, total, page, page_size } + has_more.

## Query parameters

- `container_id` integer, required — Container identifier.
- `prefix` string — folder prefix ('' for root)
- `page` integer — Page number (starts at 1).
- `page_size` integer — Items per page (1–100000, default 1000).

## Response `200`

Subfolders aggregated successfully.

- SubfoldersResponse
  - `items` string[], required — List of immediate subfolders found below the prefix.
  - `total` integer, required — Total count of distinct immediate subfolders estimated precisely.
  - `page` integer, required — Requested page index (1-based).
  - `page_size` integer, required — Page size used for the listing.
  - `has_more` boolean, required — True if there are more subfolders beyond this page.
  - `container_id` string, required — Identifier of the container that was browsed.
  - `prefix` string, required — Folder prefix used for the aggregation.

## Other responses

- `401` — Authentication required, or invalid/expired API key.
- `403` — Account banned, or pending email verification.
- `422` — Validation Error
- `429` — Rate limit exceeded. See Retry-After / X-RateLimit-* headers.
- `500` — Aggregation failed.
- `503` — Raw search under maintenance, or public API temporarily disabled.

---

[API](https://skmtc.dev/leakradar/apis/leakradar-io-api.md) · [All operations](https://skmtc.dev/leakradar/apis/leakradar-io-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/leakradar/leakradar-io-api/revisions/82a99c608e1a/schema)