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

# Scan Reality Target

`POST /api/core/reality-scan`

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

---

[API](https://skmtc.dev/socialser/apis/pasarguardapi.md) · [All operations](https://skmtc.dev/socialser/apis/pasarguardapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/socialser/pasarguardapi/revisions/4b082bbcb6c3/schema)