Assessment

Get All Assessments for a Company

Returns a list of assessments for the specified company

get/api/v2/companies/{id}/assessments

Request

Base URL
https://app.blackkitetech.com
Auth
OAuth 2
Client credentials
Token URLhttps://app.blackkitetech.com//api/v2/oauth/token
TypeScript
https://skmtc.dev/blackkitetech/apis/black-kite-api/docs/api/v2/companies/:id/assessments/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

idinteger required

Company Id

Response

List of assessments for the company

Idinteger

Id of the Assessment.

Namestring

Name of the assessment.

Descriptionstring

Description of the assessment.

Current status of the assessment.

LaunchedDatestring date-time

Date and time when the assessment was launched.

CreatedBystring

User who created the assessment. If created by API, value is 'API'. If created via portal, value is the user's full name (e.g., 'John Doe').

Example response

[
  {
    "Id": 12345,
    "Name": "Annual Cyber Risk Review",
    "Description": "Comprehensive risk assessment for 2025",
    "Status": "Completed",
    "Frameworks": [
      {
        "FrameworkName": "SOC2",
        "FrameworkFullName": "Service Organization Control 2"
      }
    ],
    "LaunchedDate": "2025-08-08T12:00:00.000Z",
    "CreatedBy": "API"
  }
]

Changes

No recorded changes to this operation across all 8 revisions of this API.