---
title: "Gets the details of a specific assessment for a monitored company."
method: GET
path: "/api/v2/companies/{id}/assessments/{assessmentId}"
tags: ["Assessment"]
---

# Gets the details of a specific assessment for a monitored company.

`GET /api/v2/companies/{id}/assessments/{assessmentId}`

Retrieves all details for the specified assessment, including summary, status, frameworks, documents, and snapshot ratings.

## Path parameters

- `id` integer, required
- `assessmentId` integer, required

## Response `200`

Assessment details retrieved successfully.

- GetAssessmentDetailsResponse
  - `Id` integer, required — Id of the Assessment.
  - `Name` string, required — Name of the assessment.
  - `Description` string — Description of the assessment.
  - `Summary` string — Summary of the assessment. This field may contain HTML-encoded text.
  - `Status` 'Analyzing' | 'InvitationSent' | 'InvitationEnqueued' | 'WaitingOnVendor' | 'ReadyToReview' | 'InReview' | 'Completed', required — Status of the assessment.
  - `OnlyApiEditable` boolean, required — If true, the assessment is only editable via API.
  - `Frameworks` object[] — List of frameworks associated with the assessment.
    - `FrameworkName` string — Code of the compliance standard.
    - `FrameworkFullName` string — Full name of the compliance standard.
    - `Ratings` object — Compliance ratings for the framework.
      - `FullyCompliant` integer — Number of compliant items.
      - `PartiallyCompliant` integer — Number of partially compliant items.
      - `Failed` integer — Number of failed items.
      - `InsufficientEvidence` integer, nullable — Number of insufficient evidence items. Nullable. If null, the value should be represented as 'n/a'.
      - `NoEvidence` integer — Number of items with no evidence.
      - `NotApplicable` integer — Number of not applicable items.
  - `Documents` object[] — List of documents associated with the assessment.
    - `Id` integer — Id of the document.
    - `FileName` string — Name of the document file.
    - `Type` string — Type of the document (e.g., 'Policies and Procedure', 'Audits and Internal Review', 'Compliance and Regulatory Report', 'Risk and Vulnerability Assessment').
    - `Date` string, date-time — Date of the document.
    - `DateSource` string — Source of the document date (e.g., 'Document Metadata', 'Document Content').
    - `UploadDate` string, date-time — Date and time when the document was uploaded.
    - `UploadedBy` string — User who uploaded the document. If the document was uploaded via the API, the value will be "API". If uploaded via the portal, the value will be the uploader's full name.
    - `Status` 'Waiting' | 'InProgress' | 'Completed' | 'ParseError' — Status of the assessment document.
  - `SnapshotRatings` object — Snapshot ratings for the assessment.
    - `CyberRating` object — Overall cyber rating for the assessment.
      - `Grade` number, double — Numeric grade for the overall cyber rating.
      - `GradeLetter` 'A+' | 'A' | 'A-' | 'B+' | 'B' | 'B-' | 'C+' | 'C' | 'C-' | 'D+' | 'D' | 'D-' | 'F' | 'n/a' — Letter grade for the overall cyber rating.
    - `CyberRatings` object[] — List of cyber ratings by module.
      - `Module` string — Cyber rating module name.
      - `Grade` number, double — Numeric grade for the module.
      - `GradeLetter` 'A+' | 'A' | 'A-' | 'B+' | 'B' | 'B-' | 'C+' | 'C' | 'C-' | 'D+' | 'D' | 'D-' | 'F' | 'n/a' — Letter grade for the module.
    - `FairRatings` object[] — List of FAIR risk ratings.
      - `RiskType` 'Data Breach' | 'Ransomware' | 'Business Interruption' — Type of risk.
      - `AnnualLossExposureAvg` number, double — Average annual loss exposure.
    - `RsiDbiRatings` object — RSI and DBI ratings.
      - `RansomwareIndex` number, float — Ransomware index value.
      - `RansomwareIndexIndustryAverage` number, float — Industry average ransomware index.
      - `BreachIndex` number, float — Breach index value.
      - `BreachIndexIndustryAverage` number, float — Industry average breach index.
    - `RsiTrend` object[] — RSI trend data.
      - `Date` string, date-time — Date of the RSI value.
      - `Value` number, float — RSI value at the date.
    - `DbiTrend` object[] — DBI trend data.
      - `Date` string, date-time — Date of the DBI value.
      - `Value` number, float — DBI value at the date.
    - `FocusTags` object[] — List of focus tags for the assessment.
      - `Id` integer — Id of the tag.
      - `Name` string — Name of the tag.
    - `SnapshotDate` string, date-time — Date and time of the snapshot.
  - `Activities` object[] — Assessment activity history entries.
    - `HistoryType` 'LaunchAssessment' | 'ViewAssessment' | 'EditNameOrDesc' | 'EditSummary' | 'EditStatus' | 'AddComment' | 'UploadedDocToAssess' | 'UploadedDocToAttach' | 'DownloadAttachment' | 'UpdateRatings' | 'DeleteAttachment' | 'DeleteDocToAsses' | 'UploadedBKReportToAttach' | 'AssessedDocDownloaded' | 'OnlyApiEditableChanged' | 'FairCalculationCompleted' | 'AssessmentSharedWithVendor' | 'InvitationAccepted' | 'SendBacktoCustomer' | 'SendBackToVendor' | 'AssessmentUnshared' — Type of assessment history activity.
    - `InsertUser` string, nullable — User identifier who created the activity.
    - `InsertDate` string, date-time — Date and time when the activity was created.
    - `FullName` string, nullable — Full name of the actor who performed the activity.
    - `DocumentName` string, nullable — Document name associated with a comment, if any.
    - `Comment` string, nullable — Comment or description associated with the activity.

## Other responses

- `401` — Unauthorized
- `404` — Not Found
- `default` — Failure

---

[API](https://skmtc.net/blackkitetech/apis/black-kite-api.md) · [All operations](https://skmtc.net/blackkitetech/apis/black-kite-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blackkitetech/black-kite-api/versions/7dadaba760fb/schema)