---
title: "Analyze SSL/TLS."
method: GET
path: "/protocol/tls"
tags: ["Protocol"]
---

# Analyze SSL/TLS.

`GET /protocol/tls`

A **low level** API to analyze SSL/TLS on ip:port. Returns the supported ciphers.

## Query parameters

- `version` string, required
- `network` string
- `ip` string, required
- `port` string, required
- `servername` string

## Response `200`

Success.

- TLSVersion[]
  - `version` string
  - `supported` boolean
  - `ciphers` object[]
    - `name` string
    - `security` string

## Other responses

- `400` — Bad request
- `500` — An error occured while scanning.

## Changes

- **2022-05-27** `d707d70e97da` — 1 breaking, 2 warning, 2 info
  - added the new required `query` request parameter `ip`
  - deleted the `query` request parameter `target`
  - removed the optional property `items/ciphers/items/type` from the response with the `200` status
  - added the optional property `items/ciphers/items/name` to the response with the `200` status
  - …1 more
- **2022-05-24** `76a4425afeb6` — 1 breaking, 1 info
  - the `items/ciphers/items/` response's property type/format changed from `string`/`` to `object`/`` for status `200`
  - added the optional property `items/ciphers/items/type` to the response with the `200` status
- **2022-05-22** `893bc6a40a9d` — 2 breaking, 4 warning, 1 info
  - added the new required `query` request parameter `target`
  - the response's body type/format changed from `object`/`` to `array`/`` for status `200`
  - deleted the `query` request parameter `ip`
  - removed the optional property `ciphers` from the response with the `200` status
  - …3 more
- **2022-05-05** `784d1c9e20bc` — 1 info
  - added the optional property `version` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/elmasy-com/apis/elmasy-api/changes/protocol/tls/get.md)

---

[API](https://skmtc.dev/elmasy-com/apis/elmasy-api.md) · [All operations](https://skmtc.dev/elmasy-com/apis/elmasy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/elmasy-com/elmasy-api/revisions/7e77337b2cee/schema)