---
title: "List Documents Org"
method: GET
path: "/api/v1/ai/organization/knowledge/documents"
tags: ["Knowledge"]
---

# List Documents Org

`GET /api/v1/ai/organization/knowledge/documents`

## Request

- Base URL: `https://www.gooddata.ai`
- URL: `https://www.gooddata.ai/api/v1/ai/organization/knowledge/documents`
- Auth: none declared

List org-scoped knowledge documents.

## Query parameters

- `scopes` string[]
- `size` integer
- `pageToken` string
- `metaInclude` string
- `state` 'enabled' | 'disabled'
- `query` string

## Response `200`

Successful Response

- ListDocumentsResponse: Response for GET /documents.
  - `documents` DocumentMetadataResponse[], required
    - `createdAt` string, required
    - `createdBy` string, required
    - `filename` string, required
    - `id` string, required
    - `isDisabled` boolean
    - `numChunks` integer, required
    - `scopes` string[], required
    - `title` string
    - `updatedAt` string, required
    - `updatedBy` string, required
    - `workspaceId` string
  - `nextPageToken` string
  - `totalCount` integer

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api.md) - [All operations](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/revisions/c728ef303bfb?raw)