SSL monitors
curl --request GET \
--url https://api.checklyhq.com/v1/analytics/ssl/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.checklyhq.com/v1/analytics/ssl/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.checklyhq.com/v1/analytics/ssl/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.checklyhq.com/v1/analytics/ssl/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.checklyhq.com/v1/analytics/ssl/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.checklyhq.com/v1/analytics/ssl/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.checklyhq.com/v1/analytics/ssl/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"checkId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"checkType": "AGENTIC",
"activated": true,
"muted": true,
"frequency": 123,
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"tags": [
"<string>"
],
"series": [
{
"data": [
{}
]
}
],
"pagination": {
"page": 123,
"limit": 123
},
"metadata": {
"handshakeTimeMs": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"daysUntilExpiry": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"tlsVersion": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"cipherSuite": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"hostnameVerified": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"chainTrusted": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"ocspStapled": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"keySizeBits": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineVerdict": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineGrade": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"availability": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"retries": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"handshakeTimeMs_avg": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"handshakeTimeMs_max": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"handshakeTimeMs_median": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"handshakeTimeMs_min": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"handshakeTimeMs_p50": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"handshakeTimeMs_p90": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"handshakeTimeMs_p95": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"handshakeTimeMs_p99": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"handshakeTimeMs_stddev": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"handshakeTimeMs_sum": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"daysUntilExpiry_avg": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"daysUntilExpiry_max": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"daysUntilExpiry_median": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"daysUntilExpiry_min": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"daysUntilExpiry_p50": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"daysUntilExpiry_p90": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"daysUntilExpiry_p95": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"daysUntilExpiry_p99": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"daysUntilExpiry_stddev": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"daysUntilExpiry_sum": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"tlsVersion_avg": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"tlsVersion_max": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"tlsVersion_median": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"tlsVersion_min": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"tlsVersion_p50": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"tlsVersion_p90": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"tlsVersion_p95": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"tlsVersion_p99": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"tlsVersion_stddev": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"tlsVersion_sum": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"cipherSuite_avg": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"cipherSuite_max": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"cipherSuite_median": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"cipherSuite_min": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"cipherSuite_p50": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"cipherSuite_p90": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"cipherSuite_p95": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"cipherSuite_p99": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"cipherSuite_stddev": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"cipherSuite_sum": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"hostnameVerified_avg": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"hostnameVerified_max": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"hostnameVerified_median": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"hostnameVerified_min": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"hostnameVerified_p50": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"hostnameVerified_p90": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"hostnameVerified_p95": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"hostnameVerified_p99": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"hostnameVerified_stddev": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"hostnameVerified_sum": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"chainTrusted_avg": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"chainTrusted_max": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"chainTrusted_median": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"chainTrusted_min": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"chainTrusted_p50": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"chainTrusted_p90": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"chainTrusted_p95": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"chainTrusted_p99": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"chainTrusted_stddev": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"chainTrusted_sum": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"ocspStapled_avg": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"ocspStapled_max": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"ocspStapled_median": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"ocspStapled_min": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"ocspStapled_p50": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"ocspStapled_p90": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"ocspStapled_p95": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"ocspStapled_p99": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"ocspStapled_stddev": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"ocspStapled_sum": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"keySizeBits_avg": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"keySizeBits_max": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"keySizeBits_median": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"keySizeBits_min": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"keySizeBits_p50": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"keySizeBits_p90": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"keySizeBits_p95": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"keySizeBits_p99": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"keySizeBits_stddev": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"keySizeBits_sum": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineVerdict_avg": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineVerdict_max": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineVerdict_median": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineVerdict_min": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineVerdict_p50": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineVerdict_p90": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineVerdict_p95": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineVerdict_p99": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineVerdict_stddev": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineVerdict_sum": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineGrade_avg": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineGrade_max": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineGrade_median": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineGrade_min": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineGrade_p50": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineGrade_p90": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineGrade_p95": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineGrade_p99": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineGrade_stddev": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineGrade_sum": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
}
}
}{
"statusCode": 123,
"error": "<string>",
"message": "<string>"
}{
"statusCode": 123,
"error": "<string>",
"message": "<string>"
}{
"statusCode": 123,
"error": "<string>",
"message": "<string>"
}{
"statusCode": 123,
"error": "<string>",
"message": "<string>"
}{
"statusCode": 123,
"error": "<string>",
"message": "<string>"
}Analytics
SSL monitors
Fetch detailed availability metrics and aggregated or non-aggregated SSL Monitor metrics across custom time ranges. For example, you can get the p99 and p95 of the TLS handshake time together with the availability percentage for any time range. Rate-limiting is applied to this endpoint, you can send 30 requests / 60 seconds at most.
GET
/
v1
/
analytics
/
ssl
/
{id}
SSL monitors
curl --request GET \
--url https://api.checklyhq.com/v1/analytics/ssl/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.checklyhq.com/v1/analytics/ssl/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.checklyhq.com/v1/analytics/ssl/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.checklyhq.com/v1/analytics/ssl/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.checklyhq.com/v1/analytics/ssl/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.checklyhq.com/v1/analytics/ssl/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.checklyhq.com/v1/analytics/ssl/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"checkId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"checkType": "AGENTIC",
"activated": true,
"muted": true,
"frequency": 123,
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"tags": [
"<string>"
],
"series": [
{
"data": [
{}
]
}
],
"pagination": {
"page": 123,
"limit": 123
},
"metadata": {
"handshakeTimeMs": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"daysUntilExpiry": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"tlsVersion": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"cipherSuite": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"hostnameVerified": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"chainTrusted": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"ocspStapled": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"keySizeBits": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineVerdict": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineGrade": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"availability": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"retries": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"handshakeTimeMs_avg": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"handshakeTimeMs_max": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"handshakeTimeMs_median": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"handshakeTimeMs_min": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"handshakeTimeMs_p50": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"handshakeTimeMs_p90": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"handshakeTimeMs_p95": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"handshakeTimeMs_p99": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"handshakeTimeMs_stddev": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"handshakeTimeMs_sum": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"daysUntilExpiry_avg": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"daysUntilExpiry_max": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"daysUntilExpiry_median": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"daysUntilExpiry_min": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"daysUntilExpiry_p50": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"daysUntilExpiry_p90": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"daysUntilExpiry_p95": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"daysUntilExpiry_p99": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"daysUntilExpiry_stddev": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"daysUntilExpiry_sum": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"tlsVersion_avg": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"tlsVersion_max": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"tlsVersion_median": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"tlsVersion_min": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"tlsVersion_p50": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"tlsVersion_p90": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"tlsVersion_p95": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"tlsVersion_p99": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"tlsVersion_stddev": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"tlsVersion_sum": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"cipherSuite_avg": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"cipherSuite_max": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"cipherSuite_median": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"cipherSuite_min": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"cipherSuite_p50": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"cipherSuite_p90": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"cipherSuite_p95": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"cipherSuite_p99": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"cipherSuite_stddev": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"cipherSuite_sum": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"hostnameVerified_avg": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"hostnameVerified_max": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"hostnameVerified_median": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"hostnameVerified_min": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"hostnameVerified_p50": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"hostnameVerified_p90": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"hostnameVerified_p95": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"hostnameVerified_p99": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"hostnameVerified_stddev": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"hostnameVerified_sum": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"chainTrusted_avg": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"chainTrusted_max": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"chainTrusted_median": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"chainTrusted_min": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"chainTrusted_p50": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"chainTrusted_p90": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"chainTrusted_p95": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"chainTrusted_p99": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"chainTrusted_stddev": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"chainTrusted_sum": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"ocspStapled_avg": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"ocspStapled_max": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"ocspStapled_median": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"ocspStapled_min": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"ocspStapled_p50": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"ocspStapled_p90": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"ocspStapled_p95": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"ocspStapled_p99": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"ocspStapled_stddev": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"ocspStapled_sum": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"keySizeBits_avg": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"keySizeBits_max": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"keySizeBits_median": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"keySizeBits_min": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"keySizeBits_p50": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"keySizeBits_p90": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"keySizeBits_p95": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"keySizeBits_p99": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"keySizeBits_stddev": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"keySizeBits_sum": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineVerdict_avg": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineVerdict_max": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineVerdict_median": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineVerdict_min": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineVerdict_p50": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineVerdict_p90": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineVerdict_p95": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineVerdict_p99": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineVerdict_stddev": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineVerdict_sum": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineGrade_avg": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineGrade_max": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineGrade_median": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineGrade_min": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineGrade_p50": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineGrade_p90": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineGrade_p95": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineGrade_p99": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineGrade_stddev": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
},
"baselineGrade_sum": {
"unit": "milliseconds",
"label": "<string>",
"aggregation": "avg"
}
}
}{
"statusCode": 123,
"error": "<string>",
"message": "<string>"
}{
"statusCode": 123,
"error": "<string>",
"message": "<string>"
}{
"statusCode": 123,
"error": "<string>",
"message": "<string>"
}{
"statusCode": 123,
"error": "<string>",
"message": "<string>"
}{
"statusCode": 123,
"error": "<string>",
"message": "<string>"
}Authorizations
The Checkly Public API uses API keys to authenticate requests. You can get the API Key here. Your API key is like a password: keep it secure!
Authentication to the API is performed using the Bearer auth method in the Authorization header and using the account ID.
For example, set Authorization header while using cURL: curl -H "Authorization: Bearer [apiKey]" "X-Checkly-Account: [accountId]"
Headers
Your Checkly account ID, you can find it at https://app.checklyhq.com/settings/account/general
Path Parameters
Minimum string length:
1Query Parameters
Custom start time of reporting window in unix timestamp format. Setting a custom "from" timestamp overrides the use of any "quickRange".
Custom end time of reporting window in unix timestamp format. Setting a custom "to" timestamp overrides the use of any "quickRange".
Preset reporting windows are used for quickly generating report on commonly used windows. Can be overridden by using a custom "to" and "from" timestamp.
Available options:
last24Hours, last7Days, last30Days, thisWeek, thisMonth, lastWeek, lastMonth The time interval to use for aggregating metrics in minutes. For example, five minutes is 5, 24 hours is 1440.
Required range:
1 <= x <= 43200Example:
1440
Filter based on whether a check result was either failing or passing
Available options:
success, failure Example:
["failure"]
Determines how the series data is grouped. Note that grouped queries are a bit more expensive and might take longer.
Available options:
runLocation Available metrics for SSL Monitors. You can pass multiple metrics as a comma separated string.
Available options:
handshakeTimeMs, daysUntilExpiry, tlsVersion, cipherSuite, hostnameVerified, chainTrusted, ocspStapled, keySizeBits, baselineVerdict, baselineGrade, availability, retries, handshakeTimeMs_avg, handshakeTimeMs_max, handshakeTimeMs_median, handshakeTimeMs_min, handshakeTimeMs_p50, handshakeTimeMs_p90, handshakeTimeMs_p95, handshakeTimeMs_p99, handshakeTimeMs_stddev, handshakeTimeMs_sum, daysUntilExpiry_avg, daysUntilExpiry_max, daysUntilExpiry_median, daysUntilExpiry_min, daysUntilExpiry_p50, daysUntilExpiry_p90, daysUntilExpiry_p95, daysUntilExpiry_p99, daysUntilExpiry_stddev, daysUntilExpiry_sum, tlsVersion_avg, tlsVersion_max, tlsVersion_median, tlsVersion_min, tlsVersion_p50, tlsVersion_p90, tlsVersion_p95, tlsVersion_p99, tlsVersion_stddev, tlsVersion_sum, cipherSuite_avg, cipherSuite_max, cipherSuite_median, cipherSuite_min, cipherSuite_p50, cipherSuite_p90, cipherSuite_p95, cipherSuite_p99, cipherSuite_stddev, cipherSuite_sum, hostnameVerified_avg, hostnameVerified_max, hostnameVerified_median, hostnameVerified_min, hostnameVerified_p50, hostnameVerified_p90, hostnameVerified_p95, hostnameVerified_p99, hostnameVerified_stddev, hostnameVerified_sum, chainTrusted_avg, chainTrusted_max, chainTrusted_median, chainTrusted_min, chainTrusted_p50, chainTrusted_p90, chainTrusted_p95, chainTrusted_p99, chainTrusted_stddev, chainTrusted_sum, ocspStapled_avg, ocspStapled_max, ocspStapled_median, ocspStapled_min, ocspStapled_p50, ocspStapled_p90, ocspStapled_p95, ocspStapled_p99, ocspStapled_stddev, ocspStapled_sum, keySizeBits_avg, keySizeBits_max, keySizeBits_median, keySizeBits_min, keySizeBits_p50, keySizeBits_p90, keySizeBits_p95, keySizeBits_p99, keySizeBits_stddev, keySizeBits_sum, baselineVerdict_avg, baselineVerdict_max, baselineVerdict_median, baselineVerdict_min, baselineVerdict_p50, baselineVerdict_p90, baselineVerdict_p95, baselineVerdict_p99, baselineVerdict_stddev, baselineVerdict_sum, baselineGrade_avg, baselineGrade_max, baselineGrade_median, baselineGrade_min, baselineGrade_p50, baselineGrade_p90, baselineGrade_p95, baselineGrade_p99, baselineGrade_stddev, baselineGrade_sum Limit the number of results
Required range:
1 <= x <= 100Page number
Required range:
x > 0Response
Success
Available options:
AGENTIC, API, BROWSER, HEARTBEAT, ICMP, MULTI_STEP, TCP, PLAYWRIGHT, TRACEROUTE, URL, DNS, SSL, GRPC Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Was this page helpful?
⌘I