---
title: "POST /tlsscan"
method: POST
path: "/tlsscan"
tags: ["tlsscan"]
---

# POST /tlsscan

`POST /tlsscan`

Perform TLS scan for a given domain

## Request body

- TlsScanDto
  - `url` string, required — Target URL

## Response `200`

Successfully retrieved TLS scan information

- TlsScanResponseDto
  - `timestamp` number, required — Timestamp of the request in milliseconds
  - `apiStatus` 'success' | 'failure', required — API status message
  - `apiCode` number, required — API status code
  - `meta` TlsScanMetaDto, required
    - `url` string, required — The target URL checked for TLS support
    - `test` TestMetaDto, required
      - `id` string, required — Unique test identifier
  - `data` TlsScanDataDto, required
    - `protocols` TlsProtocolsDto, required
      - `tls10` boolean, required — Whether TLS 1.0 is supported
      - `tls11` boolean, required — Whether TLS 1.1 is supported
      - `tls12` boolean, required — Whether TLS 1.2 is supported
      - `tls13` boolean, required — Whether TLS 1.3 is supported
    - `certificate` TlsCertificateDto, required
      - `commonName` string, required — Common name (CN) on the certificate
      - `subjectAltName` string, required — Subject Alternative Names (SAN)
      - `issuer` TlsCertificateIssuerDto, required
        - `country` string, required — Issuer country
        - `organization` string, required — Issuer organization
        - `commonName` string, required — Issuer common name
      - `expiry` string, required — Certificate expiry date

## Other responses

- `400` — Bad request (invalid parameters)
- `500` — Internal server error

---

[API](https://skmtc.net/geekflare/apis/geekflare-api.md) · [All operations](https://skmtc.net/geekflare/apis/geekflare-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/geekflare/geekflare-api/versions/936993afc936/schema)