v1

latestOpenAPI 3.1.02026-07-244190162.0 KB

Get Domain SSL

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

get/domain/{hostname}/ssl

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"
    }
  ]
}