---
title: "Get assessment by ID"
method: GET
path: "/vendors/{vendorId}/assessments/{assessmentId}"
tags: ["Vendors"]
---

# Get assessment by ID

`GET /vendors/{vendorId}/assessments/{assessmentId}`

## Request

- Base URL: `https://api.vanta.com`
- URL: `https://api.vanta.com/vendors/{vendorId}/assessments/{assessmentId}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/vanta/apis/build-integrations/docs/vendors/:vendorId/assessments/:assessmentId/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a single assessment for a vendor.

## Path parameters

- `vendorId` string, required
- `assessmentId` string, required

## Response `200`

Ok

- VendorAssessment
  - `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.

---

[API](https://skmtc.dev/vanta/apis/build-integrations.md) - [All operations](https://skmtc.dev/vanta/apis/build-integrations/llms.txt) - [OpenAPI document](https://skmtc.dev/vanta/apis/build-integrations/revisions/6c1f7590538b?raw)