---
title: "Scan Reality Target"
method: POST
path: "/api/core/reality-scan"
tags: ["Core"]
---

# Scan Reality Target

`POST /api/core/reality-scan`

## Request

- Base URL: `https://api.ha-man2.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ha-man2.com/api/core/reality-scan`
- Auth: OAuth 2
  - Password
  - Token URL: `/api/admin/token`

## Request body

- RealityScanRequest
  - `target` string, required: host or host:port to probe (port defaults to 443)
  - `timeout` number, nullable: Per-probe timeout in seconds (1-20, default 10)

## Response `200`

Successful Response

- RealityScanResult
  - `target` string, required
  - `host` string, required
  - `ip` string, nullable
  - `port` integer, required
  - `sni` string, nullable
  - `sni_discovered` boolean
  - `feasible` boolean, required
  - `tls13` boolean, required
  - `tls_version` string, nullable
  - `h2` boolean, required
  - `alpn` string, nullable
  - `x25519` boolean, nullable
  - `post_quantum` boolean, nullable
  - `curve` string, nullable
  - `h3` boolean
  - `cert_valid` boolean, required
  - `cert_subject` string, nullable
  - `cert_issuer` string, nullable
  - `not_after` string, nullable
  - `server_names` string[]
  - `latency_ms` integer, nullable
  - `reason` string, nullable

## Other responses

- `401`: Unauthorized Error
- `403`: Forbidden Error
- `422`: Validation Error

## Changes

- **2026-11-03** `a7dc3fda908f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ha-man2/apis/pasarguardapi/changes/api/core/reality-scan/post.md)

---

[API](https://skmtc.dev/ha-man2/apis/pasarguardapi.md) - [All operations](https://skmtc.dev/ha-man2/apis/pasarguardapi/llms.txt) - [OpenAPI document](https://skmtc.dev/ha-man2/apis/pasarguardapi/revisions/a7dc3fda908f?raw)