---
title: "List Assessments"
method: GET
path: "/v1/assessments"
tags: ["Assessments"]
---

# List Assessments

`GET /v1/assessments`

## Request

- Base URL: `https://api.mindfort.app`
- URL: `https://api.mindfort.app/v1/assessments`
- Auth: HTTP bearer

Lists assessments for your organization. Results use cursor pagination and do not include a total count.

## Query parameters

- `target_id` string, uuid
- `assessment_type` 'black-box' | 'white-box'
- `assessment_method` 'balanced' | 'deep' | 'ultra'
- `status` 'active' | 'completed' | 'failed' | 'canceled'
- `order_by` 'created_at' | 'updated_at'
- `order_direction` 'asc' | 'desc'
- `limit` integer
- `cursor` string

## Response `200`

Assessments returned successfully

- PublicAssessmentList
  - `assessments` PublicAssessmentLifecycle[], required
    - `id` string, uuid, required
    - `target_id` string, uuid, required
    - `target_name` string, nullable, required
    - `assessment_type` 'black-box' | 'white-box', required
    - `assessment_method` 'balanced' | 'deep' | 'ultra' | 'null', nullable, required
    - `status` 'active' | 'completed' | 'failed' | 'canceled', required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `started_at` string, date-time, nullable, required
    - `completed_at` string, date-time, nullable, required
    - `failure_reason` string, nullable: Customer-visible reason recorded for a failed assessment. Null for non-failed assessments or when no reason was recorded.
  - `pagination` PublicAssessmentPagination, required
    - `limit` integer, required
    - `has_more` boolean, required
    - `next_cursor` string, nullable, required

## Other responses

- `400`: Invalid filter, limit, or cursor
- `401`: Unauthorized – missing or invalid API key
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/mindfort/apis/mindfort-api.md) - [All operations](https://skmtc.dev/mindfort/apis/mindfort-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mindfort/apis/mindfort-api/revisions/cb93bd79eebe?raw)