Skip to main content
GET
/
certificates
/
{id}
Get Certificate
curl --request GET \
  --url https://api.example.com/certificates/{id}

Request

curl https://api.certwatch.app/v1/certificates/cert_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

Path Parameters

ParameterTypeDescription
idstringCertificate ID (e.g., cert_abc123)

Response

{
  "data": {
    "id": "cert_abc123",
    "domain": "example.com",
    "name": "Main Website",
    "status": "valid",
    "daysUntilExpiry": 45,
    "expiresAt": "2025-02-22T15:00:00Z",
    "issuedAt": "2024-02-22T15:00:00Z",
    "issuer": "Let's Encrypt",
    "subject": "example.com",
    "subjectAlternativeNames": [
      "example.com",
      "www.example.com"
    ],
    "serialNumber": "04:AB:CD:EF:12:34:56:78",
    "signatureAlgorithm": "SHA256withRSA",
    "port": 443,
    "alertThresholds": [30, 14, 7, 3, 1],
    "lastCheckedAt": "2025-01-08T12:00:00Z",
    "createdAt": "2024-01-01T00:00:00Z",
    "updatedAt": "2025-01-08T12:00:00Z",
    "chain": [
      {
        "subject": "example.com",
        "issuer": "R3",
        "validFrom": "2024-02-22T15:00:00Z",
        "validTo": "2025-02-22T15:00:00Z"
      },
      {
        "subject": "R3",
        "issuer": "ISRG Root X1",
        "validFrom": "2020-09-04T00:00:00Z",
        "validTo": "2025-09-15T16:00:00Z"
      }
    ]
  },
  "meta": {
    "requestId": "req_xyz789"
  }
}

Response Fields

FieldTypeDescription
idstringUnique certificate identifier
domainstringDomain being monitored
namestringOptional friendly name
statusstringCurrent status
daysUntilExpiryintegerDays until certificate expires
expiresAtstringExpiration date (ISO 8601)
issuedAtstringIssue date (ISO 8601)
issuerstringCertificate Authority
subjectstringCertificate subject (CN)
subjectAlternativeNamesarrayAll domains covered
serialNumberstringCertificate serial number
signatureAlgorithmstringCryptographic algorithm
portintegerPort being monitored
alertThresholdsarrayConfigured alert days
lastCheckedAtstringLast check timestamp
chainarrayCertificate chain details

Errors

404 Not Found

{
  "error": {
    "code": "certificate_not_found",
    "message": "Certificate not found"
  }
}

401 Unauthorized

{
  "error": {
    "code": "invalid_api_key",
    "message": "The provided API key is invalid"
  }
}