---
title: "Return SSL statistics"
method: GET
path: "/ssl"
tags: ["SSL", "Method GET"]
---

# Return SSL statistics

`GET /ssl`

Returns SSL statistics.

## Query parameters

- `fields` string

## Response `200`

Success

- NginxSSLObject
  - `handshakes` integer — The total number of successful SSL handshakes.
  - `handshakes_failed` integer — The total number of failed SSL handshakes.
  - `session_reuses` integer — The total number of session reuses during SSL handshake.
  - `no_common_protocol` integer — The number of SSL handshakes failed because of no common protocol.
  - `no_common_cipher` integer — The number of SSL handshakes failed because of no shared cipher.
  - `handshake_timeout` integer — The number of SSL handshakes failed because of a timeout.
  - `peer_rejected_cert` integer — The number of failed SSL handshakes when nginx presented the certificate to the client but it was rejected with a corresponding alert message.
  - `verify_failures` object — SSL certificate verification errors
    - `no_cert` integer — A client did not provide the required certificate.
    - `expired_cert` integer — An expired or not yet valid certificate was presented by a client.
    - `revoked_cert` integer — A revoked certificate was presented by a client.
    - `hostname_mismatch` integer — Server's certificate doesn't match the hostname.
    - `other` integer — Other SSL certificate verification errors.

## Other responses

- `404` — Unknown version (*UnknownVersion*)

---

[API](https://skmtc.dev/nginx/apis/nginx-plus-rest-api.md) · [All operations](https://skmtc.dev/nginx/apis/nginx-plus-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nginx/nginx-plus-rest-api/revisions/533ae7834228/schema)