---
title: "List assessments by vendor ID"
method: GET
path: "/vendors/{vendorId}/assessments"
tags: ["Vendors"]
---

# List assessments by vendor ID

`GET /vendors/{vendorId}/assessments`

Returns a vendor's assessments across all assessment types.

## Path parameters

- `vendorId` string, required

## 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.
- `typeIdMatchesAny` string[]
- `statusMatchesAny` AssessmentStatus[]

## Response `200`

Ok

- PaginatedResponseVendorAssessment
  - `results` object, required
    - `data` VendorAssessment[], required
      - `id` string, required — Unique identifier for the assessment.
      - `vendorId` string, required — Unique identifier for the vendor.
      - `status` 'NOT_STARTED' | 'IN_PROGRESS' | 'COMPLETED', required — The lifecycle status of an assessment: - NOT_STARTED: The assessment has not yet been started. - IN_PROGRESS: The assessment is underway. - COMPLETED: The assessment has been completed.
      - `completedByUserId` string, nullable, required — The Vanta user ID of the person who completed this assessment.
      - `startDate` string, date-time, nullable, required — The timestamp of when the assessment was started.
      - `dueDate` string, date-time, nullable, required — The timestamp of when the assessment is due.
      - `overrideDueDate` string, date-time, nullable, required — A manual override timestamp of when the assessment is due.
      - `completionDate` string, date-time, nullable, required — The timestamp of when the assessment was marked as completed.
      - `createdDate` string, date-time, required — The timestamp of when the assessment was created.
      - `decision` object, nullable, required — An object containing information about the decision of the assessment.
        - `comments` string, nullable, required — Comments about the assessment decision.
        - `lastUpdatedAt` string, date-time, required — The timestamp of when the assessment decision was last set.
        - `status` 'APPROVED' | 'NOT_APPROVED' | 'CONDITIONALLY_APPROVED', required — The current decision made for an assessment: - APPROVED: The assessment has been approved. - NOT_APPROVED: The assessment has been marked not approved. - CONDITIONALLY_APPROVED: The assessment has been conditionally approved.
      - `assessmentType` AssessmentType, required
        - `id` string, required — Unique identifier for the assessment type.
        - `name` string, required — Display name of the assessment type.
        - `description` string, nullable, required — Description of the assessment type, if set.
      - `owner` AssessmentOwner, required
        - `id` string, required — Unique identifier for the owner.
        - `type` 'USER' | 'TEAM', required
        - `displayName` string, nullable, required — Display name of the owner, if available.
        - `email` string, nullable, required — Email of the owner. Populated for USER owners, null for TEAM owners.
    - `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)