Public REST/JSON reference

SSL Guardian API

Monitor SSL certificate health and WHOIS expiry for any number of domains. Get alerts before things break — 90-day, 30-day, 14-day, and 7-day windows. Free tier covers 3 domains; paid tiers scale to thousands. Part of the Logic Igniter Developer & DevOps bundle.

Access boundary

These examples describe public API calls only. Use the service output to review, score, summarize, analyze, or recommend; do not treat the API reference as permission for an assistant to write, send, publish, charge, schedule, notify, delete, or modify records.

Base URL

https://api.logicigniter.com

Auth

Authorization: Bearer YOUR_API_KEY

Version

OpenAPI 3.0.3 · 1.0.0

Spec

/api-specs/sslguardian.json

Operations rendered

Response models rendered

GET/api/v1/sslguardian/check

Free SSL/WHOIS quick check

Run a single-shot SSL + WHOIS check against any hostname. No auth required, rate-limited per IP. Use this to demo the service or to verify a single domain without an API key.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`domain`required	query	string	Hostname to check (no protocol, no path).

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/sslguardian/check" \
  -H "Accept: application/json"

Responses

200CheckResult

Check completed

400Error

Missing or malformed `domain` parameter

429Error

Rate limit exceeded — try again later or sign up for a free API key.

GET/api/v1/sslguardian/health

Service liveness

Liveness probe — returns 200 if the service is reachable. Safe to call as often as your monitoring needs.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/sslguardian/health" \
  -H "Accept: application/json"

Responses

200

Service healthy

GET/api/v1/sslguardian/domains

List monitored domains

Return the workspace's monitored domains, paginated.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`page_size`	query	integer
`page_token`	query	string

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/sslguardian/domains" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200DomainsResponse

Page of domains

401Error

Missing or invalid API key.

POST/api/v1/sslguardian/domains

Add a domain to monitor

Register a hostname for ongoing SSL + WHOIS monitoring. The first check runs asynchronously; poll `GET /domains/{id}/certificate` for results.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request body (required)

Schema: AddDomainRequest

Sample JSON payload for evaluation.

{
  "hostname": "example.com"
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/sslguardian/domains" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"hostname":"example.com"}'

Responses

201Domain

Domain registered

400Error

Invalid hostname

401Error

Missing or invalid API key.

402Error

Endpoint requires an active subscription. The free tier covers `/check` and the first 3 monitored domains; the paid plan unlocks the rest.

GET/api/v1/sslguardian/domains/{domain_id}/certificate

Certificate detail for a domain

Read the latest observed certificate detail for a registered domain — issuer, subject, SANs, chain validity, validity window.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`domain_id`required	path	string (uuid)

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/sslguardian/domains/:domain_id/certificate" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200CertificateDetail

Certificate detail

401Error

Missing or invalid API key.

404Error

Domain not found or no observation yet

GET/api/v1/sslguardian/certificates/expiring

Certificates expiring soon

List certificates expiring within `within_days` (default 30). Sorted earliest-expiring first. Empty array if nothing is expiring.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`within_days`	query	integer

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/sslguardian/certificates/expiring" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200ExpiringCertsResponse

Expiring certificates

401Error

Missing or invalid API key.

GET/api/v1/sslguardian/alerts

List alerts

Return the workspace's expiry alerts, paginated. Alerts fire when a monitored cert/domain crosses one of the configured day-thresholds.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`page_size`	query	integer
`page_token`	query	string

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/sslguardian/alerts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200AlertsResponse

Page of alerts

401Error

Missing or invalid API key.

PUT/api/v1/sslguardian/alerts/config

Configure alert thresholds

Replace the workspace's alert day-thresholds. Defaults are [90, 30, 14, 7]. Pass an empty array to disable alerts.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request body (required)

Schema: ConfigureRequest

Sample JSON payload for evaluation.

{
  "alert_day_thresholds": [
    60,
    30,
    14,
    7
  ]
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X PUT "https://api.logicigniter.com/api/v1/sslguardian/alerts/config" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"alert_day_thresholds":[60,30,14,7]}'

Responses

200AlertConfig

Updated config

401Error

Missing or invalid API key.

402Error

Endpoint requires an active subscription. The free tier covers `/check` and the first 3 monitored domains; the paid plan unlocks the rest.

POST/api/v1/sslguardian/alerts/{alert_id}/acknowledge

Acknowledge an alert

Mark an alert as acknowledged so it stops re-firing in subsequent windows.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`alert_id`required	path	string (uuid)

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/sslguardian/alerts/:alert_id/acknowledge" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200AckResult

Alert acknowledged

401Error

Missing or invalid API key.

404Error

Alert not found

GET/api/v1/sslguardian/customers

List customers

Return the workspace's customer records, paginated.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`page_size`	query	integer
`page_token`	query	string

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/sslguardian/customers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200CustomersResponse

Page of customers

401Error

Missing or invalid API key.

POST/api/v1/sslguardian/customers

Provision a customer

Idempotent customer provision. Creates a workspace customer record on first call; returns the existing record on subsequent calls.

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Request body (required)

Schema: CreateCustomerRequest

Sample JSON payload for evaluation.

{
  "email": "[email protected]",
  "name": "Example Inc."
}

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X POST "https://api.logicigniter.com/api/v1/sslguardian/customers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]","name":"Example Inc."}'

Responses

201Customer

Customer created or returned

400Error

Invalid email or missing name

401Error

Missing or invalid API key.

GET/api/v1/sslguardian/customers/{id}

Get a customer by id

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`id`required	path	string (uuid)

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X GET "https://api.logicigniter.com/api/v1/sslguardian/customers/:id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

Responses

200Customer

Customer record

401Error

Missing or invalid API key.

404Error

Customer not found

PUT/api/v1/sslguardian/customers/{id}

Update a customer

Public REST/JSON operation

This operation is documented for direct API evaluation. It describes the public payload and response contract only; assistant/MCP usage remains read only and is covered in the MCP guide.

Parameters

Name	In	Type	Notes
`id`required	path	string (uuid)

Request body (required)

Schema: UpdateCustomerRequest

Request example

Replace placeholders with your confirmed access key and your own business data.

curl -X PUT "https://api.logicigniter.com/api/v1/sslguardian/customers/:id" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{}'

Responses

200Customer

Updated customer

400Error

Invalid update

401Error

Missing or invalid API key.

404Error

Customer not found

Data models

Error

Field	Type	Notes
`error`required	string

Domain

Field	Type	Notes
`id`required	string (uuid)
`hostname`required	string	Example: "example.com"
`ssl_expiry_date`	string (date-time)
`whois_expiry_date`	string (date-time)
`registrar`	string
`status`required	enum(DOMAIN_STATUS_UNSPECIFIED \| DOMAIN_STATUS_OK \| DOMAIN_STATUS_WARNING \| DOMAIN_STATUS_EXPIRED \| DOMAIN_STATUS_UNKNOWN)	One of: DOMAIN_STATUS_UNSPECIFIED, DOMAIN_STATUS_OK, DOMAIN_STATUS_WARNING, DOMAIN_STATUS_EXPIRED, DOMAIN_STATUS_UNKNOWN
`last_checked_at`	string (date-time)

AddDomainRequest

Field	Type	Notes
`hostname`required	string

DomainsResponse

Field	Type	Notes
`items`	array<Domain>
`next_page_token`	string
`total_count`	integer

CheckResult

Field	Type	Notes
`id`	string
`issues_found`	boolean
`issues`	array<string>
`domain`	string
`domains`	array<string>
`count`	integer

CertificateDetail

Field	Type	Notes
`id`	string (uuid)
`domain_id`	string (uuid)
`issuer`	string
`subject`	string
`sans`	array<string>
`chain_valid`	boolean
`not_before`	string (date-time)
`not_after`	string (date-time)

ExpiringCertsResponse

Field	Type	Notes
`items`	array<CertificateDetail>
`count`	integer

ExpiryAlert

Field	Type	Notes
`id`	string (uuid)
`domain_id`	string (uuid)
`alert_type`	enum(ALERT_TYPE_UNSPECIFIED \| ALERT_TYPE_SSL_EXPIRY \| ALERT_TYPE_WHOIS_EXPIRY)	One of: ALERT_TYPE_UNSPECIFIED, ALERT_TYPE_SSL_EXPIRY, ALERT_TYPE_WHOIS_EXPIRY
`days_remaining`	integer
`severity`	enum(ALERT_SEVERITY_UNSPECIFIED \| ALERT_SEVERITY_INFO \| ALERT_SEVERITY_WARNING \| ALERT_SEVERITY_CRITICAL)	One of: ALERT_SEVERITY_UNSPECIFIED, ALERT_SEVERITY_INFO, ALERT_SEVERITY_WARNING, ALERT_SEVERITY_CRITICAL
`acknowledged`	boolean
`sent_at`	string (date-time)

AlertsResponse

Field	Type	Notes
`items`	array<ExpiryAlert>
`next_page_token`	string
`total_count`	integer

ConfigureRequest

Field	Type	Notes
`alert_day_thresholds`required	array<integer>

AlertConfig

Field	Type	Notes
`id`	string (uuid)
`alert_day_thresholds`	array<integer>

AckResult

Field	Type	Notes
`success`	boolean

CreateCustomerRequest

Field	Type	Notes
`email`required	string (email)
`name`required	string

UpdateCustomerRequest

Field	Type	Notes
`email`	string (email)
`name`	string

Customer

Field	Type	Notes
`id`	string (uuid)
`email`	string (email)
`name`	string
`created_at`	string (date-time)

CustomersResponse

Field	Type	Notes
`items`	array<Customer>
`next_page_token`	string
`total_count`	integer