List Domain Certificates

The MerkleMap certificates endpoint allows you to retrieve all SSL/TLS certificates associated with a specific domain.

Endpoint

https://api.merklemap.com/v1/certificates/:hostname

URL Parameters

Name
hostname
Type
string
Description
The domain name to retrieve certificates for (e.g., example.com).

Query Parameters

Name
page
Type
integer
Description
The page number for paginated results. Starts at 0. Defaults to 0.

Response Format

The response returns a paginated list of certificates with 50 items per page.

Request Examples

GET

/v1/certificates/:hostname

curl -G https://api.merklemap.com/v1/certificates/example.com \
-d page=0 \
-H "Authorization: Bearer your_api_token_here"

JSON Response

{
    "certificates": [
        {
            "is_precertificate": false,
            "subject_common_name": "example.com",
            "serial_number": "123456789",
            "not_before": "2024-01-01T00:00:00Z",
            "not_after": "2025-01-01T00:00:00Z",
            "public_key_algorithm": "RSA",
            "public_key_size": 2048,
            "fingerprint_sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
            "fingerprint_sha1": "da39a3ee5e6b4b0d3255bfef95601890afd80709"
        }
    ],
    "has_next_page": true
}

Error Response

{
    "error": "Not Found",
    "message": "No certificates found for the specified domain"
}