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

# Gets FAIR factors for a specific assessment of a monitored company.

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

## Request

- Base URL: `https://app.blackkitetech.com`
- URL: `https://app.blackkitetech.com/api/v2/companies/{id}/assessments/{assessmentId}/fairfactors`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://app.blackkitetech.com//api/v2/oauth/token`
- TypeScript: <https://skmtc.dev/blackkitetech/apis/black-kite-api/docs/api/v2/companies/:id/assessments/:assessmentId/fairfactors/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves FAIR risk factors for the specified assessment, including factor metadata, mapped framework control, rating, and relevant scenarios.

## Path parameters

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

## Response `200`

Assessment FAIR factors retrieved successfully.

- GetAssessmentFairFactorsResponse
  - `FairFactors` AssessmentFairFactorResponse[], required: List of FAIR factors returned for the assessment.
    - `Id` string, required: FAIR factor control code (e.g. FIF01, FIF02).
    - `FactorName` string, required: Name of the FAIR risk factor.
    - `FrameworkControlId` integer, required: Database identifier of the assessment framework control record.
    - `Rating` 'NoEvidence' | 'NotImplemented' | 'Implemented', required: Current FAIR factor rating.
    - `RelevantScenarios` string[], required: Risk scenarios to which this factor applies.
    - `Description` string, required: Description of the FAIR factor from the compliance standard.
  - `TotalCount` integer, required: Total number of FAIR factors returned.
  - `AssessmentId` integer, required: Identifier of the assessment.
  - `CompanyId` integer, required: Identifier of the company.
  - `AssessmentName` string, nullable: Assessment name for context.

## Other responses

- `400`: Invalid request or input
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `default`: Failure

---

[API](https://skmtc.dev/blackkitetech/apis/black-kite-api.md) - [All operations](https://skmtc.dev/blackkitetech/apis/black-kite-api/llms.txt) - [OpenAPI document](https://skmtc.dev/blackkitetech/apis/black-kite-api/revisions/0950b35c0e4a?raw)