---
title: "Get Assessment"
method: GET
path: "/v1/assessments/{assessment_id}"
tags: ["Assessments"]
---

# Get Assessment

`GET /v1/assessments/{assessment_id}`

## Request

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

Retrieve dashboard-aligned assessment progress, including stage_progress, planned testing stages, current statuses, and start/completion timestamps when available. Use stage_progress rather than reconciling expected_testing_stages with stages.state yourself.

## Path parameters

- `assessment_id` string, uuid, required

## Response `200`

Successful response

- PublicAssessmentDetail
  - `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.
  - `expected_testing_stages` PublicExpectedAssessmentStage[], required: Target-specific testing stages expected for this assessment. A stage without a matching entry in stages.state has not started yet.
    - `id` string, required: Planned testing-stage identifier.
    - `name` string, required: Customer-visible expected stage name.
  - `stages` PublicAssessmentStages, required
    - `state` object, required: Assessment stages indexed by stage identifier.
  - `stage_progress` PublicAssessmentStageProgress[], required: Progress for planned and recorded assessment stages. Use this instead of reconciling expected_testing_stages with stages.state. NOT_STARTED means expected but not yet observed.
    - `activity_type` 'RECON' | 'TESTING' | 'VALIDATION' | 'AUTHENTICATION', required
    - `assessment_stage` string, required: Assessment stage identifier.
    - `name` string, required: Customer-visible stage name.
    - `status` 'NOT_STARTED' | 'RUNNING' | 'ACTIVE' | 'COMPLETED' | 'SKIPPED' | 'FAILED' | 'TIMED_OUT' | 'CANCELED' | 'TERMINATED' | 'CONTINUED_AS_NEW', required
    - `attempt` integer, nullable, required
    - `executors` PublicAssessmentExecutorStage[], nullable, required: Individual test run statuses and start/completion times; null when no individual runs are reported for this stage.
      - `name` string, nullable: Name of the test run, when available.
      - `status` 'starting' | 'in_progress' | 'done' | 'failed' | 'cancelled', required
      - `attempt` integer, nullable
      - `started_at` string, date-time, nullable: When this test run started, or null when not recorded.
      - `completed_at` string, date-time, nullable: When this test run finished, or null while active or unrecorded.

## Other responses

- `400`: Invalid request
- `401`: Missing or invalid API key
- `403`: Not permitted for this organization
- `404`: Resource not found

---

[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)