Skip to main content
GET
List Assessments

Authorizations

Authorization
string
header
required

API key generated from the MindFort dashboard. Pass as Authorization: Bearer <your-api-key>.

Query Parameters

target_id
string<uuid>

Filter by target UUID

assessment_type
enum<string>

Filter by assessment type. white-box returns assessments that include code assessment; black-box returns assessments that do not.

Available options:
black-box,
white-box
assessment_method
enum<string>

Filter by assessment method

Available options:
balanced,
deep,
ultra
status
enum<string>

Filter by assessment status

Available options:
active,
completed,
failed,
canceled
order_by
enum<string>
default:created_at

Sort field for cursor pagination

Available options:
created_at,
updated_at
order_direction
enum<string>
default:desc

Sort direction for cursor pagination

Available options:
asc,
desc
limit
integer
default:25

Maximum number of assessments to return

Required range: 1 <= x <= 100
cursor
string

Opaque URL-safe base64 cursor from pagination.next_cursor; it binds order_by and order_direction and carries the last sort_at and id.

Response

Assessments returned successfully

assessments
PublicAssessmentLifecycle · object[]
required
pagination
PublicAssessmentPagination · object
required