Skip to content

List certificates

Lists your certificates, newest first, with the certificateId every other call needs. Filter by domain to find the certificates on one name.

Request

GET /api/v1/ssls?domainName=apiname.com&skipCount=0&maxResultCount=10
Parameter Required Notes
domainName optional Only certificates on this domain. For a wildcard, *.apiname.com and apiname.com find the same certificates.
skipCount optional Default 0.
maxResultCount optional Default 10, maximum 1000.

Response — 200

{
"totalCount": 2,
"items": [
{
"certificateId": "9b41d0e6-7c2a-4f58-8e13-6a5f2d9c7b20",
"domainName": "apiname.com",
"packageCode": "POSITIVESSL",
"packageName": "PositiveSSL",
"status": "WaitingForInstall",
"statusReason": "None",
"isConfigured": false,
"isIssued": false,
"purchasedAt": "2027-10-18T09:20:14",
"subscriptionExpiresAt": "2028-10-18T09:20:14",
"certificateExpiresAt": null,
"renewedFromCertificateId": "5e8c2a71-4b93-4f06-ae25-1d7f9c3b8042"
},
{
"certificateId": "5e8c2a71-4b93-4f06-ae25-1d7f9c3b8042",
"domainName": "apiname.com",
"packageCode": "POSITIVESSL",
"packageName": "PositiveSSL",
"status": "Active",
"statusReason": "None",
"isConfigured": true,
"isIssued": true,
"purchasedAt": "2026-10-30T16:12:40",
"subscriptionExpiresAt": "2027-10-30T16:12:40",
"certificateExpiresAt": "2027-11-28T23:59:59",
"renewedFromCertificateId": null
}
]
}
Field Meaning
certificateId Send this to every other SSL endpoint.
domainName, packageCode, packageName What the certificate is for.
status A certificate status name, e.g. Active, WaitingForInstall, Renewed.
statusReason Why it reached that status — see below.
isConfigured, isIssued Whether configure has been done, and whether the CA has issued it.
purchasedAt, subscriptionExpiresAt The subscription you paid for. Renewal reminders run off subscriptionExpiresAt.
certificateExpiresAt When the issued certificate stops being valid. null until it is issued.
renewedFromCertificateId On a renewal: the certificateId of the certificate it renews. null otherwise.

Status reasons

Name Meaning
None The normal flow.
ConfigurationWindowExpired Not configured within 15 days and cancelled. Refundable packages are refunded automatically.
ResellerRevoked You called revoke.
AdminCancelled Cancelled by our team.
ProviderCancelled The CA cancelled the order.
CertificateExpired The certificate ran out while the subscription is still running. Reissue it.
SubscriptionExpired The subscription ended. Renew it.