API documentation

Manage your monitored domains and read their certificate status from your own tools: deployment scripts, dashboards, internal tools.

The API is included in the Agency plan. See pricing

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.

Contact support

This site only uses the cookies it needs to work (sign-in, security, language). To improve it, we measure traffic with Umami, without cookies or personal data. You can opt out. Learn more