---
title: "Combine current general assessments for this subject"
method: GET
path: "/api/v1/risk/subjects/{subjectId}/compositions/{compositionVersionId}"
tags: ["Risk"]
---

# Combine current general assessments for this subject

`GET /api/v1/risk/subjects/{subjectId}/compositions/{compositionVersionId}`

## Request

- Base URL: `https://api.korala.ai`
- URL: `https://api.korala.ai/api/v1/risk/subjects/{subjectId}/compositions/{compositionVersionId}`
- Auth: one of:
  - API key in header `X-API-Key`
  - `bearer` (a scheme the document does not define)

## Path parameters

- `subjectId` string, required
- `compositionVersionId` string, required

## Headers

- `Idempotency-Key` string
- `X-Risk-Mode` string
- `X-Korala-Mode` 'live' | 'test'

## Response `200`

- RiskCompositionStateDto
  - `subjectId` string, uuid, required
  - `compositionVersionId` string, uuid, required
  - `result` RiskCompositionResultDto, required
    - `status` 'complete' | 'incomplete', required
    - `decision` 'none' | 'review' | 'restrict' | 'reject' | 'awaiting_evidence', required
    - `actions` string[], required
    - `validUntil` string, date-time, nullable, required
    - `evaluatorVersion` 'risk-policy-composition-v1', required
    - `eligibility` 'eligible' | 'ineligible' | 'unknown', required
    - `clearance` boolean, required: True only when every applicable component is current and complete, participation is eligible, and no component requires an adverse risk decision.
    - `components` RiskComposedPolicyDto[], required
      - `key` string, required
      - `policyVersionId` string, uuid, required
      - `contextId` string, uuid, nullable, required
      - `assessmentId` string, uuid, nullable, required
      - `evaluatorVersion` string, nullable, required
      - `state` 'ready' | 'not_applied' | 'unknown_applicability' | 'withdrawn' | 'unavailable' | 'missing' | 'not_current', required
    - `evidence` RiskCompositionEvidenceDto[], required
      - `evidenceId` string, uuid, required
      - `componentKeys` string[], required
    - `historicalFindings` RiskCompositionHistoricalFindingDto[], required
      - `decision` 'none' | 'review' | 'restrict' | 'reject' | 'awaiting_evidence', required
      - `key` string, required
      - `policyVersionId` string, uuid, required
      - `assessmentId` string, uuid, required
      - `evaluatorVersion` string, required
      - `eligibility` 'eligible' | 'ineligible' | 'unknown', required
      - `evidenceIds` string[], required

## Other responses

- `400`: Malformed UUID in path parameter (`subjectId`, `compositionVersionId`).

---

[API](https://skmtc.dev/korala/apis/korala-public-api.md) · [All operations](https://skmtc.dev/korala/apis/korala-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/korala/apis/korala-public-api/revisions/5c4d7810c507?raw)