{
  "openapi": "3.1.0",
  "info": {
    "title": "SSL Checker Api",
    "version": "1.0.0",
    "description": "Check any hostname's TLS certificate: validity, issuer, covered names and days until expiry, live.\n\nCheck the TLS certificate of any hostname in one call: whether it is valid and trusted, who issued it, which names it covers, and when it expires, with the days remaining. Built for uptime monitors, security checks and expiry alerts.",
    "contact": {
      "name": "Data and APIs",
      "url": "https://dataandapis.com/contact"
    },
    "termsOfService": "https://dataandapis.com/terms-of-service",
    "license": {
      "name": "Data and APIs Terms of Service",
      "url": "https://dataandapis.com/terms-of-service"
    },
    "x-logo": {
      "url": "https://dataandapis.com/images/ssl-checker-api.webp"
    }
  },
  "externalDocs": {
    "description": "Documentation, live tester and pricing",
    "url": "https://dataandapis.com/apis/ssl-checker-api"
  },
  "servers": [
    {
      "url": "https://ssl-checker-api.dataandapis.com"
    }
  ],
  "tags": [
    {
      "name": "Monitoring",
      "description": "SSL Checker Api belongs to the Monitoring category of the Data and APIs catalog."
    }
  ],
  "paths": {
    "/v1/check": {
      "get": {
        "operationId": "checksSslCertificate",
        "summary": "Checks SSL Certificate",
        "description": "Checks SSL Certificate endpoint of the SSL Checker Api. Costs 10 tokens per call.",
        "externalDocs": {
          "url": "https://dataandapis.com/apis/ssl-checker-api/checks-ssl-certificate"
        },
        "parameters": [
          {
            "name": "hostname",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "wikipedia.org"
          },
          {
            "name": "port",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "example": "443"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful response",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "success": true,
                  "data": {
                    "hostname": "wikipedia.org",
                    "port": 443,
                    "valid": true,
                    "validFrom": "Oct  9 23:02:03 2025 GMT",
                    "validTo": "Jan  7 23:02:02 2026 GMT",
                    "daysUntilExpiry": 35,
                    "issuer": {
                      "C": "US",
                      "O": "Lets Encrypt",
                      "CN": "E7"
                    },
                    "subject": {
                      "CN": "*.wikipedia.org"
                    },
                    "serialNumber": "05E99AFAE9E9285C9A6B8CA6FEFF26C23F9B",
                    "fingerprint": "28:F1:C8:C5:9F:B5:BC:B6:B6:37:54:D7:A4:E7:21:61:38:D3:AB:D7",
                    "fingerprint256": "D8:BB:C0:CA:A9:93:C7:BA:CA:E3:11:33:64:69:5A:BA:BF:CE:12:94:95:F3:E0:28:39:E5:B8:AC:8D:DA:1B:78",
                    "keyUsage": [
                      "1.3.6.1.5.5.7.3.1",
                      "1.3.6.1.5.5.7.3.2"
                    ],
                    "subjectAltName": "DNS:*.m.mediawiki.org, DNS:*.m.wikibooks.org, DNS:*.m.wikidata.org, DNS:*.m.wikimedia.org, DNS:*.m.wikinews.org, DNS:*.m.wikipedia.org, DNS:*.m.wikiquote.org, DNS:*.m.wikisource.org, DNS:*.m.wikiversity.org, DNS:*.m.wikivoyage.org, DNS:*.m.wiktionary.org, DNS:*.mediawiki.org, DNS:*.planet.wikimedia.org, DNS:*.wikibooks.org, DNS:*.wikidata.org, DNS:*.wikifunctions.org, DNS:*.wikimedia.org, DNS:*.wikimediafoundation.org, DNS:*.wikinews.org, DNS:*.wikipedia.org, DNS:*.wikiquote.org, DNS:*.wikisource.org, DNS:*.wikiversity.org, DNS:*.wikivoyage.org, DNS:*.wiktionary.org, DNS:*.wmfusercontent.org, DNS:mediawiki.org, DNS:w.wiki, DNS:wikibooks.org, DNS:wikidata.org, DNS:wikifunctions.org, DNS:wikimedia.org, DNS:wikimediafoundation.org, DNS:wikinews.org, DNS:wikipedia.org, DNS:wikiquote.org, DNS:wikisource.org, DNS:wikiversity.org, DNS:wikivoyage.org, DNS:wiktionary.org, DNS:wmfusercontent.org",
                    "cipher": {
                      "name": "TLS_AES_128_GCM_SHA256",
                      "standardName": "TLS_AES_128_GCM_SHA256",
                      "version": "TLSv1.3"
                    },
                    "protocol": "TLSv1.3",
                    "authorized": true,
                    "authorizationError": null
                  }
                }
              }
            }
          },
          "401": {
            "description": "Missing or invalid API key"
          },
          "402": {
            "description": "Subscription past due; the response carries a payment_url"
          },
          "429": {
            "description": "Monthly token allowance exhausted"
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "ApiKey": {
        "type": "apiKey",
        "in": "header",
        "name": "X-Api-Key",
        "description": "Create a free key at https://dataandapis.com/sign-up. 500 tokens a month on the Free plan; this API costs 10 tokens per call."
      }
    }
  },
  "security": [
    {
      "ApiKey": []
    }
  ]
}