> ## Documentation Index
> Fetch the complete documentation index at: https://alliancebioversityciat-alliance-risk-analysis-tool.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get assessment

Retrieve a single assessment by ID.

## Path parameters

**id** `string` *required*

Assessment ID (UUID).

## Response

**id** `string`

Unique assessment identifier (UUID).

**name** `string`

Assessment name.

**companyName** `string`

Company name.

**companyType** `string`

Company type.

**country** `string`

Country of operation.

**status** `string`

Current assessment status.

Values:

* `DRAFT` - Initial state, data collection in progress
* `ANALYZING` - AI analysis in progress
* `ACTION_REQUIRED` - Waiting for user input or gap resolution
* `COMPLETE` - Assessment and report complete

**intakeMode** `string`

Data collection method.

Values: `UPLOAD`, `GUIDED_INTERVIEW`, `MANUAL_ENTRY`

**progress** `number`

Completion percentage (0-100).

**version** `number`

Version number for optimistic locking.

**overallRiskScore** `number`

Aggregated risk score across all categories (0-100). Null until analysis is complete.

**overallRiskLevel** `string`

Overall risk classification. Null until analysis is complete.

Values: `LOW`, `MODERATE`, `HIGH`, `CRITICAL`

**userId** `string`

ID of the user who created the assessment.

**createdAt** `string`

ISO 8601 timestamp of creation.

**updatedAt** `string`

ISO 8601 timestamp of last update.

```bash cURL theme={null}
curl -X GET https://api.example.com/api/assessments/550e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer YOUR_TOKEN"
```

```javascript JavaScript theme={null}
const assessmentId = '550e8400-e29b-41d4-a716-446655440000';

const response = await fetch(
  `https://api.example.com/api/assessments/${assessmentId}`,
  {
    headers: { 'Authorization': 'Bearer YOUR_TOKEN' }
  }
);

const assessment = await response.json();
```

```python Python theme={null}
import requests

assessment_id = '550e8400-e29b-41d4-a716-446655440000'

response = requests.get(
    f'https://api.example.com/api/assessments/{assessment_id}',
    headers={'Authorization': 'Bearer YOUR_TOKEN'}
)

assessment = response.json()
```

```json 200 Response theme={null}
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "name": "Q1 2026 Risk Assessment",
  "companyName": "Acme Coffee Cooperative",
  "companyType": "Cooperative",
  "country": "Kenya",
  "status": "ANALYZING",
  "intakeMode": "UPLOAD",
  "progress": 35,
  "version": 3,
  "overallRiskScore": null,
  "overallRiskLevel": null,
  "userId": "auth0|123456789",
  "createdAt": "2026-03-04T10:30:00.000Z",
  "updatedAt": "2026-03-04T11:15:00.000Z"
}
```

```json 404 Not Found theme={null}
{
  "statusCode": 404,
  "message": "Assessment not found",
  "error": "Not Found"
}
```

```json 403 Forbidden theme={null}
{
  "statusCode": 403,
  "message": "Access denied",
  "error": "Forbidden"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.