---
title: "Get assessment history for a relationship"
method: GET
path: "/api/v1/relationship/{id}/assessments"
tags: ["client-api-relationship-rest-resource"]
---

# Get assessment history for a relationship

`GET /api/v1/relationship/{id}/assessments`

## Request

- Base URL: `https://app.visotrust.com`
- URL: `https://app.visotrust.com/api/v1/relationship/{id}/assessments`
- Auth: none declared
- TypeScript: <https://skmtc.dev/visotrust/apis/viso-trust-api-documentation/docs/api/v1/relationship/:id/assessments/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` integer, required

## Response `200`

OK

- Assessment[]
  - `id` integer
  - `recommendations` AssessmentRecommendation[]
    - `description` string
    - `createdDate` string, date-time
    - `recommendationType` 'EXPIRED' | 'HIGH_ASSURANCE' | 'CONTROL_DOMAINS' | 'COMBINED' | 'CERT_ONLY' | 'LOW_COVERAGE' | 'PRESUMED_ARTIFACT'
  - `status` 'NOT_ASSESSED' | 'AWAITING_REMEDIATION' | 'STARTED' | 'REVIEW_STARTED' | 'AUDIT_COMPLETED' | 'COMPLETED' | 'CANCELLED' | 'DELETED' | 'COLLECTING_INFORMATION' | 'EXPIRED'
  - `assessmentType` string
  - `statusHistories` AssessmentStatusHistory[]
    - `date` string, date-time
    - `status` 'NOT_ASSESSED' | 'AWAITING_REMEDIATION' | 'STARTED' | 'REVIEW_STARTED' | 'AUDIT_COMPLETED' | 'COMPLETED' | 'CANCELLED' | 'DELETED' | 'COLLECTING_INFORMATION' | 'EXPIRED'
  - `sentToFirstName` string
  - `sentToLastName` string
  - `createdReason` 'INITIAL_ASSESSMENT' | 'ARTIFACTS_EXPIRED' | 'RECERTIFICATION_INITIATED' | 'BUSINESS_CASE_OR_DATA_TYPES_CHANGED' | 'THIRD_PARTY_CONTACT_UPDATED' | 'ARTIFACTS_UPLOADED_ON_RELATIONSHIP' | 'REMEDIATION' | 'RISK_ADVISORY_RESPONSE' | 'INSTANT_ANALYSIS' | 'PUBLIC_SEARCH'
  - `sentToEmail` string
  - `createdDate` string, date-time
  - `summary` string
  - `expirationDate` string, date-time
  - `completedDate` string, date-time
  - `requestedAuditTypes` string[]
  - `aiProcessingOnly` boolean
  - `noVendorResponseAction` 'CLOSE_COLLECTION_REQUEST' | 'NOTIFY_ME'
  - `collectionTimeline` 'SEVEN_DAYS' | 'FOURTEEN_DAYS' | 'THIRTY_DAYS' | 'SIXTY_DAYS' | 'NINETY_DAYS' | 'ONE_HUNDRED_TWENTY_DAYS'
  - `followupTimeline` 'SEVEN_DAYS' | 'FOURTEEN_DAYS' | 'THIRTY_DAYS' | 'SIXTY_DAYS' | 'NINETY_DAYS'
  - `followupRiskThreshold` 'NO_CONTEXT' | 'LOW' | 'MEDIUM' | 'HIGH' | 'EXTREME'
  - `followupType` 'MANUAL' | 'AUTOMATIC' | 'CONCIERGE'
  - `sentBy` VisoUser
    - `firstName` string
    - `lastName` string
    - `email` string
    - `businessUnit` string
  - `updatedDate` string, date-time
  - `phaseDate` string, date-time
  - `requestedArtifactCollection` boolean

---

[API](https://skmtc.dev/visotrust/apis/viso-trust-api-documentation.md) - [All operations](https://skmtc.dev/visotrust/apis/viso-trust-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/visotrust/apis/viso-trust-api-documentation/revisions/98c8d5d102c9?raw)