List certificates
GET /api/v1/ssls
Section titled “GET /api/v1/ssls”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. |