Basic Intro

List your SSL tests by querying this API. You can not make changes using this call.

Example Request
curl -H "API: [APIKey]" -H "Username: [Username]" -X GET

Response Codes

  • HTTP 200 - Success
  • HTTP 401 - Authorization Required - Provide Correct Username and API key

Example Output

The output is returned as a json array

        "id": "12345",                              // Unique Test ID
        "paused": false,                            // Whether the test has been paused (Administrative only)
        "domain": "",             // URL that is being tested
        "cert_score": "95",                         // Certificate score in %
        "cipher_score": "100",                      // Cipher strength in %
        "cert_status": "CERT_OK",                   // Certificate status
        "cipher": "TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256",    // Cipher code (SSL spec)
        "valid_from_utc": "2017-10-10 14:06:00",                // Certificate Validity Start (In UTC/GMT+0)
        "valid_until_utc": "2017-12-29 00:00:00",               // Certificate Validity End (In UTC/GMT+0)
        "flags": {
            "is_extended": false,                   // Certificate has an Extended Validation certificate
            "has_pfs": true,                        // Certificate has Perfect Forward Secrecy enabled
            "is_broken": false,                     // Certificate has errors
            "is_expired": false,                    // Certificate is expired
            "is_missing": false,                    // Certificate not present
            "is_revoked": false                     // Certificate has been revoked by CA
        "contact_groups": [""],                     // Array of contactgroup IDs (numeric)
        "alert_at": "1,7,30",                       // Days when reminders should be sent - Requires alert_reminder to be true
        "last_reminder": 0,                         // The last reminder to be detected (days)
        "alert_reminder": false,                    // Set to `true` to enable reminders. See 'alert_at'
        "alert_expiry": false,                      // Set to `true` to enable expiration alerts
        "alert_broken": false,                      // Set to `true` to enable error alerts.
        "last_updated_utc": "2017-10-24 09:02:25"   // When the certificate has last been updated (Either by user action or by testing)