curl "https://api.scanova.io/custom-domain/42/ssl-certificate/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
{
"status": "ISSUED",
"expiry_status": "healthy",
"days_until_expiry": 82,
"issued_at": "2026-08-01T00:00:00Z",
"expires_at": "2026-11-01T00:00:00Z"
}
Custom Domains
Get SSL certificate status
GET /custom-domain//ssl-certificate/
GET
/
custom-domain
/
{pk}
/
ssl-certificate
/
curl "https://api.scanova.io/custom-domain/42/ssl-certificate/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
{
"status": "ISSUED",
"expiry_status": "healthy",
"days_until_expiry": 82,
"issued_at": "2026-08-01T00:00:00Z",
"expires_at": "2026-11-01T00:00:00Z"
}
Gets the SSL certificate status for a domain, on the Management API host (
If no certificate has been uploaded yet,
api.scanova.io), authenticated with your raw Management API key.
GET https://api.scanova.io/custom-domain/{pk}/ssl-certificate/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
Enterprise-only. Requires the
CUSTOM_DOMAIN_CUSTOM_SSL quota, which is granted manually — no self-serve plan includes it.integer
required
The domain’s
id.curl "https://api.scanova.io/custom-domain/42/ssl-certificate/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
{
"status": "ISSUED",
"expiry_status": "healthy",
"days_until_expiry": 82,
"issued_at": "2026-08-01T00:00:00Z",
"expires_at": "2026-11-01T00:00:00Z"
}
status and expiry_status come back null. 403 if the account lacks the CUSTOM_DOMAIN_CUSTOM_SSL quota; 404 if pk isn’t a domain owned by this account.
Related
- Upload an SSL certificate — activate a certificate for this domain.
- Create an SSL certificate request — the CSR a certificate here must match.
- Management API overview — the auth scheme and quota rules that apply to this endpoint.
Authorizations
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.
Path Parameters
Response
Certificate status, or nulls if none uploaded yet.
Was this page helpful?