> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openlayer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List a framework's documents

> List the documents attached to a framework.

A document holds the text of the standard the framework is based on, split into sections and
subsections. Retrieve a single document to get that structure, along with the rules mapped to
each part of it.




## OpenAPI

````yaml get /frameworks/{frameworkId}/documents
openapi: 3.0.3
info:
  contact:
    email: support@openlayer.com
    name: Openlayer
    url: https://openlayer.com/
  description: API for interacting with the Openlayer server.
  title: Openlayer API
  version: '1.0'
  x-logo:
    url: https://logo.clearbit.com/openlayer.com
servers:
  - url: https://api.openlayer.com/v1
    description: Our prod backend
security:
  - bearerAuth: []
paths:
  /frameworks/{frameworkId}/documents:
    get:
      tags:
        - Governance
      summary: List a framework's documents
      description: >
        List the documents attached to a framework.


        A document holds the text of the standard the framework is based on,
        split into sections and

        subsections. Retrieve a single document to get that structure, along
        with the rules mapped to

        each part of it.
      operationId: listFrameworkDocuments
      parameters:
        - $ref: '#/components/parameters/frameworkId'
        - $ref: '#/components/parameters/page'
        - $ref: '#/components/parameters/perPage'
      responses:
        '200':
          description: Status OK.
          content:
            application/json:
              schema:
                type: object
                required:
                  - items
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/FrameworkDocument'
        default:
          $ref: '#/components/responses/UnexpectedError'
      x-codeSamples:
        - lang: curl
          source: |
            curl --request GET \
              --url https://api.openlayer.com/v1/frameworks/9f1b3c2d-4e5a-4f60-8a71-2b3c4d5e6f70/documents \
              --header 'Authorization: Bearer <token>'
components:
  parameters:
    frameworkId:
      name: frameworkId
      in: path
      description: The framework id.
      required: true
      schema:
        type: string
        format: uuid
    page:
      name: page
      in: query
      description: The page to return in a paginated query.
      schema:
        type: integer
        minimum: 1
        default: 1
    perPage:
      name: perPage
      in: query
      description: Maximum number of items to return per page.
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 25
  schemas:
    FrameworkDocument:
      type: object
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
          description: The document id.
          example: 4a6c8e0f-1b2d-4e3f-9a5b-6c7d8e9f0a1b
        frameworkId:
          type: string
          format: uuid
          readOnly: true
          description: The framework the document belongs to.
        title:
          type: string
          maxLength: 512
          description: The document title.
          example: EU AI Act -- Regulation (EU) 2024/1689
        sections:
          type: array
          readOnly: true
          description: >
            The document's sections, in display order. Only returned when
            retrieving a single document.
          items:
            $ref: '#/components/schemas/FrameworkDocumentSection'
        dateCreated:
          type: string
          format: date-time
          readOnly: true
          description: The creation date.
          example: '2026-03-22T11:31:01.185Z'
        dateUpdated:
          type: string
          format: date-time
          readOnly: true
          description: The last update date.
          example: '2026-03-22T11:31:01.185Z'
      required:
        - id
        - frameworkId
        - title
        - dateCreated
        - dateUpdated
    FrameworkDocumentSection:
      type: object
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
          description: The section id.
          example: 2e4f6a8c-9b1d-4c3e-8f5a-7b9c0d1e2f3a
        documentId:
          type: string
          format: uuid
          readOnly: true
          description: The document the section belongs to.
        number:
          type: string
          maxLength: 64
          description: The section number as it appears in the source standard.
          example: Article 9
        title:
          type: string
          maxLength: 512
          description: The section title.
          example: Risk management system
        text:
          type: string
          nullable: true
          description: The section text.
        sortOrder:
          type: integer
          default: 0
          description: The position of the section within the document.
        ruleCount:
          type: integer
          minimum: 0
          readOnly: true
          description: >
            How many rules are linked to this section, including its
            subsections. Use it to decide whether to fetch the section's rules.
        rules:
          type: array
          readOnly: true
          description: The rules linked directly to this section.
          items:
            $ref: '#/components/schemas/FrameworkDocumentRule'
        subsections:
          type: array
          readOnly: true
          description: The section's subsections, in display order.
          items:
            $ref: '#/components/schemas/FrameworkDocumentSubsection'
      required:
        - id
        - documentId
        - number
        - title
        - sortOrder
    FrameworkDocumentRule:
      type: object
      properties:
        id: 41fe6bb1-fe32-4e5f-918a-078dbede63bb
        name: a21a6c67-7a72-4dce-a060-a37a9157ff19
        description: 06e1a68a-2baa-4827-a806-b20caab6db26
        scope: c850e62c-fdbc-46ac-8d48-9ee46468bf9a
        type: 760666d1-c605-4dd6-99a0-96a1975a2291
        evidenceType: b9439ea1-1246-4b80-817e-d1343b08f771
        renewalCadenceDays: 2c51e8da-3fe6-46dd-9dc1-d2f575ee7216
        automationType: 49f27a08-831a-45b8-875a-e429b1de42dc
        automationParams: 7647316d-a50e-4449-873c-d6167f8c5d67
        deactivated: 487d8f40-4a90-4e78-bf7d-5d992c161601
        immutable: 3aecd3ba-bad2-4e2f-9a50-133687933c22
        dateCreated: 32989809-110d-4793-bff7-da3694a55377
        dateUpdated: 1b6bc8eb-6ff0-4515-b7a5-903e9f724043
      required:
        - id
        - name
        - scope
        - type
    FrameworkDocumentSubsection:
      type: object
      properties:
        id:
          type: string
          format: uuid
          readOnly: true
          description: The subsection id.
          example: 1d3f5a7b-8c9e-4b2d-9f6a-0c1e2d3f4a5b
        sectionId:
          type: string
          format: uuid
          readOnly: true
          description: The section the subsection belongs to.
        number:
          type: string
          maxLength: 64
          description: The subsection number as it appears in the source standard.
          example: '9.2'
        title:
          type: string
          maxLength: 512
          description: The subsection title.
          example: Identification of known and foreseeable risks
        text:
          type: string
          nullable: true
          description: >-
            The subsection text. This is the requirement your rules are mapped
            against.
        sortOrder:
          type: integer
          default: 0
          description: The position of the subsection within its section.
        ruleCount:
          type: integer
          minimum: 0
          readOnly: true
          description: How many rules are linked to this subsection.
        rules:
          type: array
          readOnly: true
          description: The rules linked to this subsection.
          items:
            $ref: '#/components/schemas/FrameworkDocumentRule'
      required:
        - id
        - sectionId
        - number
        - title
        - sortOrder
  responses:
    UnexpectedError:
      description: Unexpected error.
      content:
        application/json:
          schema:
            type: object
            required:
              - code
              - error
            properties:
              code:
                type: integer
                format: int32
              error:
                type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >
        Bearer authentication header of the form `Bearer <token>`, where
        `<token>` is your workspace API key. See [Find your API
        key](https://www.openlayer.com/docs/workspace-and-projects/find-your-api-key)
        for more information.

````