---
title: "List documents"
method: GET
path: "/documents"
tags: ["Documents"]
---

# List documents

`GET /documents`

List documents.

## Query parameters

- `pageSize` integer — Controls the maximum number of items returned in one response from the API.
- `pageCursor` string — A marker or pointer, telling the API where to start fetching items for the subsequent page in a paginated dataset. Note that the requested page will not include the item that corresponds to this cursor but will start from the one immediately after this cursor.
- `frameworkMatchesAny` string[]
- `statusMatchesAny` DocumentStatus[]

## Response `200`

Ok

- PaginatedResponseDocument
  - `results` object, required
    - `data` Document[], required
      - `id` string, required — The document's unique ID.
      - `ownerId` string, nullable, required — The user ID of the document's owner.
      - `category` 'Accounts access' | 'Account security' | 'Account setup' | 'Computers' | 'Custom' | 'Data storage' | 'Employees' | 'Infrastructure' | 'IT' | 'Logging' | 'Monitoring alerts' | 'People' | 'Policies' | 'Risk analysis' | 'Software development' | 'CSPM alert management' | 'Vendors' | 'Vulnerability management', required
      - `description` string, required — The document's description.
      - `isSensitive` boolean, required — Determines whether or not the document is sensitive.
      - `title` string, required — The document's title.
      - `uploadStatus` 'Needs document' | 'Needs update' | 'Not relevant' | 'OK', required
      - `uploadStatusDate` string, date-time, nullable, required — The date the document's uploadStatus changed.
      - `url` string, nullable, required — The URL to view the document within Vanta.
    - `pageInfo` PageInfo, required — Provides information about the pagination of a dataset.
      - `endCursor` string, nullable, required — The cursor that points to the end of the current page, or null if there is no such cursor.
      - `hasNextPage` boolean, required — Indicates if there is another page after the current page.
      - `hasPreviousPage` boolean, required — Indicates if there is a page before the current page.
      - `startCursor` string, nullable, required — The cursor that points to the start of the current page, or null if there is no such cursor.

---

[API](https://skmtc.net/vanta/apis/build-integrations.md) · [All operations](https://skmtc.net/vanta/apis/build-integrations/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vanta/build-integrations/revisions/6c1f7590538b/schema)