API reference
Base URL: https://sslcertificates.io/api/v1. Authenticate with a bearer token. All resources are organization-scoped. Machine-readable spec: OpenAPI 3 JSON.
| Method | Path | Scope | Purpose |
|---|---|---|---|
GET |
/domains |
domains:read | List domains |
POST |
/domains |
domains:write | Create a domain |
GET |
/domains/{id} |
domains:read | Show a domain |
PATCH |
/domains/{id} |
domains:write | Update tags/status |
DELETE |
/domains/{id} |
domains:write | Delete a domain |
GET |
/certificates |
certificates:read | List certificates |
POST |
/certificates |
certificates:write | Request issuance |
GET |
/certificates/{id} |
certificates:read | Certificate detail |
GET |
/certificates/{id}/download |
certificates:read | Download PEM |
POST |
/certificates/{id}/renew |
certificates:write | Force renewal |
POST |
/certificates/{id}/revoke |
certificates:revoke | Revoke |
GET |
/certificate-orders |
certificates:read | List orders |
GET |
/certificate-orders/{id} |
certificates:read | Order status |
POST |
/certificate-orders/{id}/validate |
certificates:write | Complete validation |
GET |
/api-keys |
session | List keys |
POST |
/api-keys |
session | Create key (plaintext once) |
DELETE |
/api-keys/{id} |
session | Revoke key |
GET |
/webhooks |
webhooks:read | List endpoints |
POST |
/webhooks |
webhooks:write | Create endpoint |
POST |
/webhooks/{id}/test |
webhooks:write | Send test event |
GET |
/integrations/dns |
integrations:read | List DNS integrations |
POST |
/integrations/dns |
integrations:write | Store DNS credentials |
GET |
/custom-hostnames |
domains:read | List SaaS custom hostnames |
POST |
/custom-hostnames |
domains:write | Create a custom hostname |
GET |
/custom-hostnames/{id} |
domains:read | Show a custom hostname |
DELETE |
/custom-hostnames/{id} |
domains:write | Delete a custom hostname |
Example
curl https://sslcertificates.io/api/v1/certificates \
-H "Authorization: Bearer $SSL_CERTIFICATES_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-1" \
-d '{"domains":["example.com"],"validation":"dns-01"}'