---
title: "List Knowledge Base resources"
method: GET
path: "/knowledge-base/resources"
tags: ["Knowledge Base"]
---

# List Knowledge Base resources

`GET /knowledge-base/resources`

List Knowledge Base resources (documents and webpages) in a single
paginated response. Each entry is a discriminated union on `type` —
"FILE" entries carry a `fileUrl` (presigned S3 URL, valid for one
hour), "URL" entries carry the resource's `url` and `includeSubPages`.

Supports full-text search, type filtering, tag filtering (OR within
a category, AND across categories), and date-range filters on
last-updated and expiration.

## 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.
- `q` string
- `typeMatchesAny` KnowledgeBaseResourceTypeFilter[]
- `lastUpdatedAfter` string
- `lastUpdatedBefore` string
- `matchesTags` string
- `expiresBefore` string
- `expiresAfter` string

## Response `200`

Ok

- PaginatedResponseTrustKnowledgeBaseResourceOutput
  - `results` object, required
    - `data` TrustKnowledgeBaseResourceOutput[], required
      - union — Discriminated union over `type` of all resource kinds in the Trust Knowledge Base (currently FILE and URL).
        - KnowledgeBaseDocumentResourceOutput
          - `id` string, required
          - `type` 'FILE', required
          - `title` string, required
          - `description` string, nullable, required
          - `fileUrl` string, required — Presigned S3 URL for the underlying document. Expires after 1 hour due to AWS IAM Role limitations on presigned URL lifetimes. Re-fetch the resource to obtain a fresh URL once this one expires.
          - `customerVisibility` 'PRIVATE' | 'SHAREABLE' | 'REQUEST_ACCESS' | 'PUBLIC' | 'null', nullable, required
          - `downloadPermission` 'VIEW_ONLY' | 'VIEW_AND_DOWNLOAD' | 'null', nullable, required
          - `isUsedInQuestionnaires` boolean, nullable, required
          - `ownerAssignment` KnowledgeBaseResourceActorAssignment, required
            - `type` 'User' | 'Team', required
            - `id` string, required
            - `displayName` string, nullable, required
          - `expirationStatus` 'CURRENT' | 'EXPIRED', required — Customer-facing expiration status used by knowledge-base API responses (answer library entries and resources). Derived from the persisted `expiresAt` field at read time.
          - `expirationDate` string, nullable, required
          - `lastUpdated` string, required
          - `lastVerified` string, nullable, required
          - `tags` TagInput[], required
            - `categoryId` string, required
            - `tagId` string, required
          - `categoryId` string, nullable, required — Trust Center category id the resource is currently filed under, or `null` if uncategorized (or not on the Trust Center, which is the case for `PRIVATE` / `SHAREABLE` resources).
        - KnowledgeBaseWebpageResourceOutput
          - `id` string, required
          - `type` 'URL', required
          - `title` string, required
          - `description` string, nullable, required
          - `url` string, required
          - `customerVisibility` 'PRIVATE' | 'SHAREABLE' | 'REQUEST_ACCESS' | 'PUBLIC' | 'null', nullable, required
          - `includeSubPages` boolean, nullable, required
          - `isUsedInQuestionnaires` boolean, nullable, required
          - `ownerAssignment` KnowledgeBaseResourceActorAssignment, required
            - `type` 'User' | 'Team', required
            - `id` string, required
            - `displayName` string, nullable, required
          - `expirationStatus` 'CURRENT' | 'EXPIRED', required — Customer-facing expiration status used by knowledge-base API responses (answer library entries and resources). Derived from the persisted `expiresAt` field at read time.
          - `expirationDate` string, nullable, required
          - `lastUpdated` string, required
          - `lastVerified` string, nullable, required
          - `tags` TagInput[], required
            - `categoryId` string, required
            - `tagId` string, required
          - `categoryId` string, nullable, required — Trust Center category id the resource is currently filed under, or `null` if uncategorized (or not on the Trust Center, which is the case for `PRIVATE` / `SHAREABLE` resources).
    - `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)