API
The SSLmonitor REST API gives you direct, flexible access to your certificate and monitoring data so you can integrate it into your own applications, dashboards, and workflows. Query SSL status, expiration details, and historical data in real time, automate alerts, and build custom integrations using simple, predictable endpoints. Use the examples below to get started and tailor SSL monitoring to your exact needs.
Authentication
curl -H "Authorization: Bearer [YOUR-API-KEY]" https://api.sslmonitor.io/api/v1/[ENDPOINT]
Example Error
{
"code":404,
"message":"monitor not found"
"req_id":"76a72264-d5b9-4a0a-9856-67a67e619644" // provide when contacting customer support
}
Endpoint - Ping
Use this endpoint to test your authentication.
https://api.sslmonitor.io/api/v1/ping
Request Parameters
None
Example Response
{
"success":1,
"message":"Ok"
"date_time":"2026-01-01 00:00",
"apikey_id":888,
}
Endpoint - Account
Use this endpoint gather details about your account.
https://api.sslmonitor.io/api/v1/account
Request Parameters
None
Example Response
{
"success":1,
"message":"Ok"
"id",888,
"email","john@example.com",
"monitor_limit":10,
"monitor_used":4,
"monitor_available":6
}
Endpoint - List Monitors
https://api.sslmonitor.io/api/v1/monitor/list
Request Parameters
| name | required | examples |
|---|---|---|
| host | optional | *.domain.com |
| port | optional | 443 or 443,8443 or !443 or 100-200 or >=100 |
| ssl_valid | optional | true or false |
| ssl_expire_days | optional | =30 or 30-60 or <30 or >30 |
Example Response
{
"success":1,
"message":"Ok",
"count":1,
"list":[
{
"id":888,
"host":"www.example.com",
"port":443,
"ssl_valid":true,
"ssl_message":"Valid",
"ssl_color":"green",
"ssl_expire_days":127,
"ssl_expire_date_start":"2026-01-01 00:00",
"ssl_expire_date_end":"2026-12-12 23:59",
"ssl_host_match":true,
"ssl_issuer":"DigiCert Inc"
"http_code":200,
"scan_date":"2026-01-05 20:25",
}
]
}
Endpoint - Get Monitor
https://api.sslmonitor.io/api/v1/monitor/get
Request Parameters
| name | required | examples |
|---|---|---|
| id | required | 888 |
Example Response
{
"success":1,
"message":"Ok",
"monitor:{
"id": 888,
"host": "www.company.com",
"port": 443,
"scan_date": "2026-04-27 01:05",
"ssl": {
"date_start": "2026-01-01 00:00",
"date_end": "2026-12-31 23:59",
"expire_days": 127,
"issuer_cn": "DigiCert EV RSA CA G2",
"issuer_c": "US",
"issuer_o": "DigiCert Inc"
"subject_cn": "www.company.com",
"subject_c": "US",
"subject_o": "Company LLC",
"alt_names": [
"company.com",
"cdn.company.com",
"api.company.com",
"www.company.com"
],
},
"http": {
"ip": "11.22.33.44",
"ip_rev": "11-22-33-44.deploy.webhost.com"
"ip_geo": "US-CA",
"code": 200,
"size": 1825210,
"headers": [
{
"n": "Content-Type",
"v": "text/html; charset=utf-8"
},{
...
}
],
"html_title": "...",
"meta_description": "...",
"meta_keywords": "..."
}
}
}
Endpoint - Add Monitor
https://api.sslmonitor.io/api/v1/monitor/add
Request Parameters
Either 'host' and 'port' or 'url' parameters are required.
| name | required | examples |
|---|---|---|
| host | required | www.example.com |
| port | required | 443 |
| url | optional | https://www.example.com |
| proxy_host | optional | myproxy.example.com |
| proxy_port | optional | 3128 |
| proxy_username | optional | |
| proxy_password | optional |
Example Response
{
"success":1,
"message":"Ok",
"monitor": { ... SEE MONITOR-GET ... }
}
Endpoint - Scan Monitor
https://api.sslmonitor.io/api/v1/monitor/scan
Request Parameters
| name | required | examples |
|---|---|---|
| id | required | 888 |
Example Response
{
"success":1,
"message":"Ok",
"monitor": { ... SEE MONITOR-GET ... }
}
Endpoint - Delete Monitor
https://api.sslmonitor.io/api/v1/monitor/delete
Request Parameters
| name | required | examples |
|---|---|---|
| id | required | 888 |
Example Response
{
"success":1,
"message":"Ok"
}