Introduction
The API answers in JSON. Every URL starts with:
https://www.sslexpirationreminder.com/api/v1
Send the Accept: application/json header to get validation errors as JSON.
Authentication
Every request must include your token in the Authorization header. The token is shown on your account's API page, where you can also renew it: the old one stops working immediately.
Authorization: Bearer $TOKEN
Keep this token secret: it gives access to your account's domains.
Limits
60 requests per minute per token. Beyond that, the API answers 429: wait a minute before trying again.
The number of domains is still limited by your plan: beyond it, adding a domain answers 403.
The Domain object
Endpoints return domains in this shape, under a “data” key.
| Field | Type | Description |
|---|---|---|
| id | integer | Domain identifier. |
| domain | string | Monitored domain name. |
| valid | boolean | true if the last certificate read is valid. |
| type | string | Certificate issuer (letsencrypt, sectigo, digicert or the authority name). |
| ssl_expires_at | string|null | Certificate expiry date (ISO 8601, UTC). |
| last_check_at | string|null | Date of the last check. |
| created_at | string | Date the domain was added. |
| updated_at | string | Date of the last change. |
Endpoints
List domains
GET /api/v1/domains
Returns your domains, newest first, 15 per page. Use ?page=2 for the next page.
Request
curl https://www.sslexpirationreminder.com/api/v1/domains \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"
Response
{
"data": [
{
"id": 42,
"domain": "boutique-client.fr",
"valid": true,
"type": "letsencrypt",
"ssl_expires_at": "2026-11-16T22:59:59.000000Z",
"last_check_at": "2026-10-26T08:00:03.000000Z",
"created_at": "2026-03-02T14:12:45.000000Z",
"updated_at": "2026-10-26T08:00:03.000000Z"
}
],
"links": {
"first": "https://www.sslexpirationreminder.com/api/v1/domains?page=1",
"last": "https://www.sslexpirationreminder.com/api/v1/domains?page=1",
"prev": null,
"next": null
},
"meta": {
"current_page": 1,
"per_page": 15,
"total": 1
}
}
Add a domain
POST /api/v1/domains
Adds a domain and checks its certificate right away. https:// and paths are removed automatically.
Request
curl -X POST https://www.sslexpirationreminder.com/api/v1/domains \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"domain":"boutique-client.fr"}'
Response
{
"data": {
"id": 42,
"domain": "boutique-client.fr",
"valid": true,
"type": "letsencrypt",
"ssl_expires_at": "2026-11-16T22:59:59.000000Z",
"last_check_at": "2026-10-26T08:00:03.000000Z",
"created_at": "2026-03-02T14:12:45.000000Z",
"updated_at": "2026-10-26T08:00:03.000000Z"
}
}
Get a domain
GET /api/v1/domains/{id}
Returns one of your domains.
Request
curl https://www.sslexpirationreminder.com/api/v1/domains/42 \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"
Response
{
"data": {
"id": 42,
"domain": "boutique-client.fr",
"valid": true,
"type": "letsencrypt",
"ssl_expires_at": "2026-11-16T22:59:59.000000Z",
"last_check_at": "2026-10-26T08:00:03.000000Z",
"created_at": "2026-03-02T14:12:45.000000Z",
"updated_at": "2026-10-26T08:00:03.000000Z"
}
}
Update a domain
PUT /api/v1/domains/{id}
Changes the monitored domain name.
Request
curl -X PUT https://www.sslexpirationreminder.com/api/v1/domains/42 \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"domain":"www.boutique-client.fr"}'
Response
{
"data": {
"id": 42,
"domain": "www.boutique-client.fr",
"valid": true,
"type": "letsencrypt",
"ssl_expires_at": "2026-11-16T22:59:59.000000Z",
"last_check_at": "2026-10-26T08:00:03.000000Z",
"created_at": "2026-03-02T14:12:45.000000Z",
"updated_at": "2026-10-26T08:00:03.000000Z"
}
}
Delete a domain
DELETE /api/v1/domains/{id}
Deletes the domain and stops monitoring it. Answers 204 with no content.
Request
curl -X DELETE https://www.sslexpirationreminder.com/api/v1/domains/42 \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"
Response
HTTP/1.1 204 No Content
Error codes
| Code | Meaning |
|---|---|
| 401 | Missing or invalid token. |
| 403 | Your plan doesn't include the API, the domain limit is reached, or the domain belongs to another account. |
| 404 | Domain not found. |
| 422 | Invalid data, or the domain is already in your account. Details are in “errors”. |
| 429 | Too many requests: wait a minute. |
A question about the API?
Write to us and pick the API subject.