Skip to content

Issuance and download

Asks the CA where the order stands and updates our record. It is a PUT because it has that side effect.

Request

{
"certificateId": "5e8c2a71-4b93-4f06-ae25-1d7f9c3b8042"
}
Field Required Notes
certificateId required From initialize or renew.

Response — still validating

{
"certificateId": "5e8c2a71-4b93-4f06-ae25-1d7f9c3b8042",
"domainName": "apiname.com",
"status": "WaitingForValidation",
"statusMessage": "Waiting for domain control validation",
"isConfigured": true,
"isIssued": false,
"certificateExpiresAt": null
}

Response — issued

{
"certificateId": "5e8c2a71-4b93-4f06-ae25-1d7f9c3b8042",
"domainName": "apiname.com",
"status": "Active",
"statusMessage": "The certificate is active",
"isConfigured": true,
"isIssued": true,
"certificateExpiresAt": "2027-11-28T23:59:59"
}

Certificate statuses

Value Name What to do
1 Active Issued and in force. Download it.
2 WaitingForInstall Bought but not configured. The 15-day clock is running.
3 InstallationInProgress Installation under way — for packages installed by our technical team, until they complete it.
4 WaitingForValidation Publish the DNS record or serve the file, then keep polling.
5 ConfirmationSent Approval e-mail sent. Chase the customer.
6 WaitingForDocument The CA wants organisation documents (OV/EV vetting). They will contact the customer directly.
7 Cancelled Revoked, cancelled, or the 15-day window lapsed.
8 ConfigurationStarted Order sent to the CA, outcome not yet recorded. Do not call configure again. Keep polling.
10 Renewed Superseded by a renewal that is now active. Still valid until its own expiry, but the current certificate is the newer one, with its own certificateId.
11 Expired No longer valid. If the subscription is still running, only the certificate ran out: reissue it. If the subscription has ended too, renew it.

Errors

Code Meaning and fix
Ssl:10026 Unknown certificateId, or it is not yours.
Ssl:10049 / Ssl:10050 The CA could not be reached or rejected the query. Retry later.

Full detail for one certificate. Use it to build the customer’s certificate page.

Request

GET /api/v1/ssls/certificate?certificateId=5e8c2a71-4b93-4f06-ae25-1d7f9c3b8042

Response — 200

{
"certificateId": "5e8c2a71-4b93-4f06-ae25-1d7f9c3b8042",
"domainName": "apiname.com",
"status": "Active",
"isConfigured": true,
"isIssued": true,
"packageName": "PositiveSSL",
"packageCode": "POSITIVESSL",
"subscription": {
"purchasedAt": "2026-10-30T16:12:40",
"expiresAt": "2027-10-30T16:12:40"
},
"configuration": {
"configuredAt": "2026-10-30T16:28:11",
"configurationLink": null,
"pin": null,
"webServer": "Apache",
"authenticationType": "Cname",
"sanList": null,
"wildcardList": null,
"approverMail": "admin@apiname.com",
"csr": "-----BEGIN CERTIFICATE REQUEST-----\n...\n-----END CERTIFICATE REQUEST-----",
"dcvDetails": "{\"MD5\":\"A1B2C3D4E5F6A7B8C9D0E1F2A3B4C5D6\"}"
},
"certificate": {
"issuedAt": "2026-10-30T16:41:55",
"validUntil": "2027-11-28T23:59:59"
},
"contacts": [
{ "type": "Administration", "firstName": "Ahmet", "lastName": "Yilmaz" },
{ "type": "Technical", "firstName": "Ahmet", "lastName": "Yilmaz" }
]
}

configuration is null until configured; certificate is null until issued. Check for null before reading them.

Returns the issued certificate and its chain. Call it only once isIssued is true.

Request

GET /api/v1/ssls/certificate-content?certificateId=5e8c2a71-4b93-4f06-ae25-1d7f9c3b8042

Response — 200

{
"certificateId": "5e8c2a71-4b93-4f06-ae25-1d7f9c3b8042",
"certificate": "-----BEGIN CERTIFICATE-----\nMIIFXzCCBEegAwIBAgIR...\n-----END CERTIFICATE-----",
"intermediateCertificate1": "-----BEGIN CERTIFICATE-----\nMIIGEzCCA/ugAwIBAgIQ...\n-----END CERTIFICATE-----",
"intermediateCertificate2": "-----BEGIN CERTIFICATE-----\nMIIF3jCCA8agAwIBAgIQ...\n-----END CERTIFICATE-----",
"rootCertificate": "-----BEGIN CERTIFICATE-----\nMIIFgTCCA2mgAwIBAgIO...\n-----END CERTIFICATE-----"
}

Errors

Code Meaning and fix
Ssl:10026 Unknown certificateId, or it is not yours.
Ssl:10048 Not issued yet. Keep polling check-status. Note: this code is shared with a provider-order error, so the message you see may mention a provider order number — if isIssued is false, the real cause is simply that the certificate is not ready.