> ## Documentation Index > Fetch the complete documentation index at: https://docs.corti.ai/llms.txt > Use this file to discover all available pages before exploring further. # List 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. ## OpenAPI ````yaml /api-reference/auto-generated-openapi.yml get /documents/sections/ openapi: 3.0.0 info: title: Corti API version: 2.0.0 servers: - url: https://api.{environment}.corti.app/v2/ variables: environment: default: eu enum: - us - eu security: - AuthorizationHeader: - bearer tags: - name: Interactions - name: Recordings - name: Transcripts - name: Facts - name: Codes - name: Languages - name: Guided Documents - name: Guided Templates - name: Guided Sections - name: Documents (Classic) - name: Templates (Classic) paths: /documents/sections/: get: tags: - Guided Sections summary: List sections description: > 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. operationId: guided_sections_list parameters: - $ref: '#/components/parameters/Tenant-Name' - name: lang in: query description: >- Filter sections by BCP 47 language tag (e.g. `fr`, `de`, or `en-GB`). Repeatable. schema: type: array items: type: string style: form explode: true - name: region in: query description: >- Filter sections by ISO 3166-1 alpha-3 region code (e.g. `BEL`). Repeatable. schema: type: array items: type: string style: form explode: true - name: specialty in: query description: Filter sections by clinical specialty. Repeatable. schema: type: array items: type: string style: form explode: true - name: label in: query description: >- Filter sections by label in `key:value` format. Repeatable; matches sections that have any of the given labels. schema: type: array items: type: string style: form explode: true - name: published in: query description: >- Filter by publish status. Omit to return both published and unpublished items; set to `true` for published only, `false` for unpublished only. schema: type: boolean - name: source in: query description: >- Filter by source. Omit to return both. `user` returns only user-created sections; `corti` returns only Corti standard sections. schema: $ref: '#/components/schemas/GuidedSourceFilter' responses: '200': description: OK content: application/json: schema: type: array items: $ref: '#/components/schemas/GuidedSectionListItem' x-codeSamples: - lang: csharp label: C# .NET SDK source: > using Corti.Documents; using Corti; var client = new CortiClient( "TENANT_NAME", CortiClientEnvironment.Eu, new CortiClientAuth.ClientCredentials("client_id", "client_secret") ); await client.Documents.Sections.ListAsync(new GuidedSectionsListRequest()); - lang: javascript label: JavaScript SDK source: | import { CortiClient, CortiEnvironment } from "@corti/sdk"; const client = new CortiClient({ environment: CortiEnvironment.Eu, auth: { clientId: "YOUR_CLIENT_ID", clientSecret: "YOUR_CLIENT_SECRET" }, tenantName: "YOUR_TENANT_NAME" }); await client.documents.sections.list(); components: parameters: Tenant-Name: name: Tenant-Name in: header description: >- Identifies a distinct entity within Corti's multi-tenant system. Ensures correct routing and authentication of the request. required: true example: base schema: type: string description: >- Identifies a distinct entity within Corti's multi-tenant system. Ensures correct routing and authentication of the request. example: base schemas: GuidedSourceFilter: type: string description: Filter by content source. enum: - user - corti GuidedSectionListItem: type: object description: > Section metadata as returned by the LIST /documents/sections endpoint. Does not include the resolved `publishedVersion` — use GET /documents/sections/{sectionID} to fetch a single section with its published version resolved. required: - id - name - languages - regions - specialties - labels - createdAt - updatedAt properties: id: description: The UUID of the section. type: string format: uuid inheritedFromId: description: >- Reference to the section to inherit generation configuration from. Inherits from published version by default. type: string format: uuid nullable: true autoGenerated: description: >- True if the section was auto-generated as part of an inline section-composed POST /documents request. type: boolean source: description: >- Whether this section was created by the user, a project-related API Client or is a Corti standard resource. type: string enum: - user - corti - project name: description: The name of the section. type: string languages: description: >- BCP 47 languages this section has been tweaked for. Empty means no language-specific tweaks. type: array items: type: string regions: description: >- ISO 3166-1 alpha-3 country codes this section has been tweaked for. Empty means no region-specific tweaks. type: array items: type: string specialties: description: >- Clinical specialties this section has been tweaked for. Empty means no specialty-specific tweaks. type: array items: type: string description: description: The description for the section. type: string labels: description: >- The labels available to use as query param filter in the LIST /sections endpoint. type: array items: $ref: '#/components/schemas/GuidedLabel' createdBy: description: The UUID of the creator of this section. type: string format: uuid createdAt: description: The original timestamp when the section was created. type: string format: date-time updatedAt: description: The original timestamp when the section was last updated. type: string format: date-time deletedAt: description: >- Present when the section has been deleted. GET by ID still returns the full resource with this field populated. type: string format: date-time nullable: true GuidedLabel: type: object required: - key - value properties: key: type: string value: type: string securitySchemes: AuthorizationHeader: type: http description: Input your token scheme: bearer ````