API Documentation

Simple and powerful SSL monitoring API

Getting Started

To use the SSL Mosquito API, you need an API key. After signing up, you'll receive your personal API key.

Include your API key in the request header:

x-api-key: YOUR_API_KEY
Get Your API Key

Base URL

https://api.sslmosquito.com

Check SSL Certificate

GET

Retrieve SSL certificate information for a specific domain.

Endpoint

GET /ssl/{domain}

Parameters

ParameterTypeDescription
domainstringThe domain to check (e.g., google.de)

Example Request

curl -X GET "https://api.sslmosquito.com/ssl/google.de" \
  -H "x-api-key: YOUR_API_KEY"

Example Response

{
  "domain": "google.de",
  "status": "Valid",
  "expiresIn": "54 days",
  "validFrom": "27/10/2025",
  "validTo": "19/01/2026"
}

Create SSL Alert

POST

Set up an alert to be notified before a domain's SSL certificate expires.

Endpoint

POST /ssl-alert

Request Body

FieldTypeDescription
domainstringThe domain to monitor
daysBeforeExpirationnumberDays before expiration to trigger alert

Example Request

curl -X POST "https://api.sslmosquito.com/ssl-alert" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "example.com",
    "daysBeforeExpiration": 30
  }'

Example Response

{
  "id": "alert_abc123xyz"
}

Delete SSL Alert

DELETE

Remove an existing SSL alert by its ID.

Endpoint

DELETE /ssl-alert/{id}

Parameters

ParameterTypeDescription
idstringThe alert ID to delete

Example Request

curl -X DELETE "https://api.sslmosquito.com/ssl-alert/alert_abc123xyz" \
  -H "x-api-key: YOUR_API_KEY"

Example Response

{
  "success": true,
  "message": "Alert deleted successfully"
}

Rate Limits

API rate limits depend on your subscription plan. See our pricing page for details.

Note: If you exceed your rate limit, you'll receive a 429 (Too Many Requests) response.

Error Codes

CodeDescription
400Bad Request - Invalid parameters
401Unauthorized - Invalid or missing API key
404Not Found - Resource doesn't exist
429Too Many Requests - Rate limit exceeded
500Internal Server Error - Something went wrong on our end