> ## 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.

# List assessments

Retrieve a paginated list of assessments for the authenticated user.

## Query parameters

**status** `string`

Filter by assessment status.

Allowed values: `DRAFT`, `ANALYZING`, `ACTION_REQUIRED`, `COMPLETE`

**search** `string`

Search assessments by name or company name (case-insensitive).

**cursor** `string`

Cursor for pagination. Use the `nextCursor` from the previous response.

**limit** `number` (default: 10)

Number of assessments to return per page.

Range: 1-100

## Response

**data** `Assessment[]`

Array of assessment objects.

**Assessment properties**

**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 status: `DRAFT`, `ANALYZING`, `ACTION_REQUIRED`, or `COMPLETE`

**intakeMode** `string`

Data collection method: `UPLOAD`, `GUIDED_INTERVIEW`, or `MANUAL_ENTRY`

**progress** `number`

Completion percentage (0-100).

**version** `number`

Version number for optimistic locking.

**overallRiskScore** `number`

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

**overallRiskLevel** `string`

Risk classification: `LOW`, `MODERATE`, `HIGH`, or `CRITICAL`. Null until complete.

**userId** `string`

Creator user ID.

**createdAt** `string`

ISO 8601 creation timestamp.

**updatedAt** `string`

ISO 8601 last update timestamp.

**nextCursor** `string`

Cursor for the next page. Null if no more results.

**total** `number`

Total count of assessments matching the filter.

```bash cURL theme={null}
# List all assessments
curl -X GET "https://api.example.com/api/assessments?limit=10" \
  -H "Authorization: Bearer YOUR_TOKEN"

# Filter by status
curl -X GET "https://api.example.com/api/assessments?status=DRAFT&limit=20" \
  -H "Authorization: Bearer YOUR_TOKEN"

# Search by company name
curl -X GET "https://api.example.com/api/assessments?search=Acme" \
  -H "Authorization: Bearer YOUR_TOKEN"

# Paginate using cursor
curl -X GET "https://api.example.com/api/assessments?limit=10&cursor=550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

```javascript JavaScript theme={null}
// Fetch first page
const response = await fetch(
  'https://api.example.com/api/assessments?limit=10',
  {
    headers: { 'Authorization': 'Bearer YOUR_TOKEN' }
  }
);

const { data, nextCursor, total } = await response.json();

// Fetch next page
if (nextCursor) {
  const nextPage = await fetch(
    `https://api.example.com/api/assessments?limit=10&cursor=${nextCursor}`,
    {
      headers: { 'Authorization': 'Bearer YOUR_TOKEN' }
    }
  );
}
```

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

# Fetch first page
response = requests.get(
    'https://api.example.com/api/assessments',
    headers={'Authorization': 'Bearer YOUR_TOKEN'},
    params={'limit': 10, 'status': 'DRAFT'}
)

result = response.json()
data = result['data']
next_cursor = result['nextCursor']
total = result['total']

# Fetch next page
if next_cursor:
    next_response = requests.get(
        'https://api.example.com/api/assessments',
        headers={'Authorization': 'Bearer YOUR_TOKEN'},
        params={'limit': 10, 'cursor': next_cursor}
    )
```

```json 200 Response theme={null}
{
  "data": [
    {
      "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"
    },
    {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "name": "Annual Review 2025",
      "companyName": "Kenya Tea Growers",
      "companyType": "Cooperative",
      "country": "Kenya",
      "status": "COMPLETE",
      "intakeMode": "GUIDED_INTERVIEW",
      "progress": 100,
      "version": 8,
      "overallRiskScore": 42.5,
      "overallRiskLevel": "MODERATE",
      "userId": "auth0|123456789",
      "createdAt": "2026-02-15T08:00:00.000Z",
      "updatedAt": "2026-02-28T16:45:00.000Z"
    }
  ],
  "nextCursor": "660e8400-e29b-41d4-a716-446655440001",
  "total": 25
}
```


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