# SSLWebsites API — v1.0.0

> SSL certificate management platform. Free and premium SSL certificates with automated management, monitoring, and renewal via REST API and ACME protocol.

## Quick Reference

| I want to... | Endpoint | Auth needed? |
|--------------|----------|-------------|
| Sign up (free tier, $1 activation) | POST /api/signup { tenantId, name, email } | No |
| Create a certificate | POST /api/v1/certificates { domains, validationType, autoRenew } | Yes |
| List certificates | GET /api/v1/certificates | Yes |
| Get certificate detail | GET /api/v1/certificates/:id | Yes |
| Renew a certificate | POST /api/v1/certificates/:id/renew | Yes |
| Revoke a certificate | POST /api/v1/certificates/:id/revoke | Yes |
| Download certificate bundle | GET /api/v1/certificates/:id/download | Yes |
| Delete a certificate | DELETE /api/v1/certificates/:id | Yes |
| Get install guide | GET /api/v1/certificates/:id/install-guide/:serverType | Yes |
| Check domain availability | GET /api/v1/sdk/ssl/check-domain?domain=example.com | Yes |
| List API keys | GET /saas/api/v1/sdk/apikeys/list | Yes |
| Create API key | POST /saas/api/v1/sdk/apikeys/management/create | Yes |
| Get subscription | GET /saas/api/v1/sdk/billing/user-subscription | Yes |
| List plans | GET /saas/api/v1/sdk/billing/plans | No |
| Ask support chat | POST /api/support/message { message, sessionId } | No |

## Authentication

Bearer token: `Authorization: Bearer ssl_free_YOUR_API_KEY`

Get your key: `POST https://sslwebsites.com/api/signup`

## Certificate Types

| Type | Validation | Plans |
|------|-----------|-------|
| Single domain (example.com) | HTTP, DNS, Email, CNAME | All plans |
| Wildcard (*.example.com) | DNS only | Premium+ |
| Multi-domain SAN (up to 100) | HTTP, DNS, Email | Basic+ |
| 90-day | Auto | All plans |
| 1-year | Auto | Basic+ |

## Plans

| Plan | Price | 90-Day Certs | 1-Year | Wildcards | API Access |
|------|-------|-------------|--------|-----------|-----------|
| Free | $0 ($1 activation) | 3 | No | No | ACME only |
| Basic | $12.99/mo | Unlimited | 3 | No | Yes |
| Premium | $69.99/mo | Unlimited | 10 | Yes | Yes |
| Business | $139.99/mo | Unlimited | 25 | Yes | Yes |
| Platinum | $219.99/mo | Unlimited | Unlimited | Yes | Yes |

## Validation Methods

- **HTTP-01**: Place file at `/.well-known/acme-challenge/{token}`
- **DNS-01**: Add TXT record `_acme-challenge.{domain}` (required for wildcards)
- **Email**: Verify via email to domain admin contact
- **CNAME**: Add CNAME record for domain verification

## Server Types (Install Guides)

Apache, Nginx, IIS, cPanel, Plesk, Tomcat, AWS ELB, Cloudflare, Heroku

## ACME Protocol

ACME endpoint available on all plans. Compatible with Certbot and other ACME clients.

## Full Documentation

- Quickstart Guides: https://sslwebsites.com/docs/quickstart/
- Agent Skill File: https://sslwebsites.com/docs/quickstart/SSLWEBSITES-SKILL.md
- Swagger API Reference: https://sslwebsites.com/docs
- Support Chat: https://sslwebsites.com/api/support/message