---
title: "List sections"
method: GET
path: "/documents/sections/"
tags: ["Guided Sections"]
---

# List sections

`GET /documents/sections/`

Returns a list of sections and their metadata. Fetch a sectionId to get the full generation content.
Use query parameters to filter by language, region, specialty, label, publish status, or source.

## Query parameters

- `lang` string[]
- `region` string[]
- `specialty` string[]
- `label` string[]
- `published` boolean
- `source` 'user' | 'corti' — Filter by content source.

## Headers

- `Tenant-Name` string, required — Identifies a distinct entity within Corti's multi-tenant system. Ensures correct routing and authentication of the request.

## Response `200`

OK

- GuidedSectionListItem[]
  - `id` string, uuid, required — The UUID of the section.
  - `inheritedFromId` string, uuid, nullable — Reference to the section to inherit generation configuration from. Inherits from published version by default.
  - `autoGenerated` boolean — True if the section was auto-generated as part of an inline section-composed POST /documents request.
  - `source` 'user' | 'corti' | 'project' — Whether this section was created by the user, a project-related API Client or is a Corti standard resource.
  - `name` string, required — The name of the section.
  - `languages` string[], required — BCP 47 languages this section has been tweaked for. Empty means no language-specific tweaks.
  - `regions` string[], required — ISO 3166-1 alpha-3 country codes this section has been tweaked for. Empty means no region-specific tweaks.
  - `specialties` string[], required — Clinical specialties this section has been tweaked for. Empty means no specialty-specific tweaks.
  - `description` string — The description for the section.
  - `labels` GuidedLabel[], required — The labels available to use as query param filter in the LIST /sections endpoint.
    - `key` string, required
    - `value` string, required
  - `createdBy` string, uuid — The UUID of the creator of this section.
  - `createdAt` string, date-time, required — The original timestamp when the section was created.
  - `updatedAt` string, date-time, required — The original timestamp when the section was last updated.
  - `deletedAt` string, date-time, nullable — Present when the section has been deleted. GET by ID still returns the full resource with this field populated.

---

[API](https://skmtc.net/corti/apis/admin-api.md) · [All operations](https://skmtc.net/corti/apis/admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/corti/admin-api/versions/5d1895a1b3fc/schema)