Get Domain SSL

Fetch current and historical certificate information for any domain or subdomain.

get/domain/{hostname}/ssl

Request

  • Base URL
    https://api.securitytrails.com/v1
  • URL
    https://api.securitytrails.com/v1/domain/{hostname}/ssl
  • Auth
    none required

Path parameters

hostnamestring required

Query parameters

apikeystring required

Your SecurityTrails API key. See authentication documentation

include_subdomainsboolean

Default is false.

statusstring

Valid values are "valid", "all", and "expired". Default is valid.

Request body

pageinteger

The page of the returned results, starting at 1.

Response

200

endpointstring
record_countinteger

Example response

{
  "endpoint": "/v1/domain/stackoverflow.com/ssl",
  "meta": {
    "max_page": 1,
    "page": 1,
    "query": {
      "apikey": "rnFXhD4aAOnZlcRP9sUYk0H9XlT0I6Et",
      "domain": "stackoverflow.com",
      "include_subdomains": "False",
      "page": "1",
      "status": "valid"
    },
    "total_pages": 1
  },
  "record_count": 1,
  "records": [
    {
      "dns_names": [
        "*.askubuntu.com"
      ],
      "fingerprints": {
        "sha1": "D1121B074E8D887201AA36F8BDCFBF20F2D66D5E",
        "sha256": "C19CF5F9D8CCA7C4DBFCE6CDCF76A177435C6694A924D880ABFB311D6E76A2D3"
      },
      "issuer": {
        "common_name": "Let's Encrypt Authority X3",
        "country": [
          "US"
        ],
        "organization": [
          "Let's Encrypt"
        ]
      },
      "not_after": 1587482583,
      "not_before": 1579706583,
      "serial_number": "279496228386524295576467227942772171335399"
    }
  ]
}

Changes

No recorded changes to this operation across all 2 revisions of this API.