---
title: "Get a recon launch"
method: GET
path: "/v1/pentests/{pentest_slug}/recons/{recon_id}"
tags: ["pentests"]
---

# Get a recon launch

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

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

Return one recon launch by id (404 if not found or not authorized).

Restricted to integrators of the owning organization or partner.

Args:
    pentest_slug (str): Public pentest identifier.
    recon_id (int): Identifier of the recon launch.
    db (AsyncSession): Request-scoped database session.
    context (ActiveContext): Resolved caller identity and scope.

Returns:
    ReconResponse: The requested recon launch.

## Path parameters

- `pentest_slug` string, required
- `recon_id` integer, required

## Response `200`

Successful Response

- ReconResponse: Single recon record in a response. Attributes: id (int): Recon (launch) primary key. status (ReconStatus): Execution status. created (datetime.datetime): Creation timestamp. start_time (datetime.datetime | None): Execution start. finish_time (datetime.datetime | None): Execution end. pentest_slug (str | None): Slug of the parent pentest. Also served as the deprecated ``event_slug``.
  - `id` integer, required: Recon ID.
  - `status` 'pending' | 'in_progress' | 'finished' | 'error' | 'canceled', required: Human-readable recon execution status. Maps to ``StatusEnum`` integer values stored in the database.
  - `created` string, date-time, required: Creation timestamp.
  - `start_time` string, date-time, nullable: Execution start time.
  - `finish_time` string, date-time, nullable: Execution end time.
  - `pentest_slug` string, nullable: Slug of the parent pentest.
  - `event_slug` string, nullable, required: Previous name for pentest_slug.

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