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

# Parse TLS certificate.

`GET /protocol/tls/certificate`

A **Low Level** API parse a TLS certificate.

## Query parameters

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

## Response `200`

Success.

- Cert
  - `commonName` string
  - `hash` string
  - `alternativeNames` string[]
  - `signatureAlgorithm` string
  - `publicKey` PubKey
    - `algo` string
    - `size` integer
    - `key` string
    - `exponent` integer
    - `modulus` string
  - `serialNumber` string
  - `issuer` string
  - `notBefore` string
  - `notAfter` string
  - `verified` boolean
  - `verifiedError` string
  - `chain` Additional[]
    - `commonName` string
    - `hash` string
    - `notAfter` string
    - `issuer` string
    - `publicKey` PubKey
      - `algo` string
      - `size` integer
      - `key` string
      - `exponent` integer
      - `modulus` string
    - `signatureAlgorithm` string

## Other responses

- `400` — Bad Request.
- `500` — Internal Server Error.

## Changes

- **2022-05-28** `67bca1dd6b84` — 12 warning, 12 info
  - removed the optional property `alternativenames` from the response with the `200` status
  - removed the optional property `chain/items/commonname` from the response with the `200` status
  - removed the optional property `chain/items/notafter` from the response with the `200` status
  - removed the optional property `chain/items/publickey` from the response with the `200` status
  - …20 more
- **2022-05-28** `607f042f8d65` — 1 warning, 1 info
  - removed the optional property `notbeforre` from the response with the `200` status
  - added the optional property `notbefore` to the response with the `200` status
- **2022-05-27** `d707d70e97da` — 1 info
  - endpoint added
- **2022-04-29** `320f28510c71` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/elmasy-com/apis/elmasy-api/changes/protocol/tls/certificate/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)