---
title: "Get pentest status"
method: GET
path: "/v1/pentests/{pentest_slug}/status"
tags: ["pentests"]
---

# Get pentest status

`GET /v1/pentests/{pentest_slug}/status`

## Request

- Base URL: `https://api.ethiack.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ethiack.com/v1/pentests/{pentest_slug}/status`
- Auth: none declared

Return the pentest's aggregated run status.

The status is computed from the pentest's config and dates, so this is
a plain authorized read.

Args:
    pentest_slug (str): Public pentest identifier.
    db (AsyncSession): Request-scoped database session.
    context (ActiveContext): Resolved caller identity and scope.

Returns:
    PentestResponse: The pentest with its current status.

## Path parameters

- `pentest_slug` string, required

## Response `200`

Successful Response

- PentestResponse: Public test representation (list item). Attributes: id (int): Pentest primary key. slug (str): Unique pentest slug. name (str): Pentest display name. pic (str | None): Pentest picture URL, nullable. pentest_type (int): Pentest type code (serialized as label). pentest_category (int | None): Pentest category code, nullable (serialized as label). status (int): Lifecycle status (serialized as label). dimension_type (int | None): Dimension type (serialized as label). organization_id (int): Owning organization ID. start_date (datetime.datetime): Scheduled start. end_date (datetime.datetime): Scheduled end. created (datetime.datetime): Creation timestamp.
  - `id` integer, required
  - `slug` string, required
  - `name` string, required
  - `pic` string, nullable
  - `pentest_type` string, required
  - `pentest_category` string, nullable
  - `status` string, required
  - `dimension_type` string, nullable
  - `organization_id` integer, required
  - `start_date` string, date-time, required
  - `end_date` string, date-time, required
  - `created` string, date-time, required
  - `event_type` string, required: Previous name for pentest_type.
  - `event_category` string, nullable, required: Previous name for pentest_category.

## Other responses

- `422`: Validation Error

---

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