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

# Get a pentest

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

## 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}/`
- Auth: none declared

Return one pentest by slug (404 if not found or not authorized).

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

Returns:
    PentestDetailResponse: The requested pentest.

## Path parameters

- `pentest_slug` string, required

## Response `200`

Successful Response

- PentestDetailResponse: Detailed test representation (single-item view). Extends :class:`PentestResponse` with configuration, location, content, and report fields. Attributes: latitude (float | None): Pentest latitude. longitude (float | None): Pentest longitude. md (str | None): Pentest description in Markdown. html (str | None): Pentest description in HTML. eh (int): Pentest bounty balance. draft (bool): Whether the test is in draft state. configuration_finished (bool | None): Configuration complete flag. open_for_applications (bool): Whether hackers can apply. active_recon_enabled (bool): Active recon enabled. final_report_url (str | None): Final report download URL. executive_report_url (str | None): Executive report download URL. data (dict): Arbitrary test metadata (JSONB).
  - `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
  - `latitude` number, nullable
  - `longitude` number, nullable
  - `md` string, nullable
  - `html` string, nullable
  - `eh` integer
  - `draft` boolean
  - `configuration_finished` boolean, nullable
  - `open_for_applications` boolean
  - `active_recon_enabled` boolean
  - `final_report_url` string, nullable
  - `executive_report_url` string, nullable
  - `data` object, nullable
  - `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)