Search
Send your domain as thequery parameter (3–1024 characters). The default field is domain, so a bare domain matches it. To scope by issue date, add a createdAt clause with the AND, OR, and NOT operators. Because the query syntax uses :, let curl -G --data-urlencode handle the encoding.
certificate_database_search.
This source costs 0 credits per call and is throttled at 10,000 requests per day.
Request parameters
What comes back
The response is a paginated envelope. The certificates are incontent; the surrounding fields describe the page you are on.
Page envelope fields:
content— array of certificate records (see below).hasContent—truewhen this page holds at least one certificate.number— current page index (zero-based).size— page size used for this request.totalElements— total certificates matching the query.totalPages— total pages available.numberOfElements— count of certificates on this page.first/last— booleans flagging the first and last page.follow_up_token— token that replays this exact search later.
content is one certificate:
id— the certificate’s record ID.createdAt— when the record was indexed (YYYY-MM-DD HH:MM:SS).domain— the domain or host the certificate was issued for.notBefore— start of the certificate’s validity window (YYYY-MM-DD HH:MM:SS).notAfter— end of the validity window (YYYY-MM-DD HH:MM:SS).algorithm— the signature algorithm.fingerprint— the certificate fingerprint.serialNumber— the certificate serial number.issuer— the certificate authority that signed it.cvssScore— risk score attached to the record, when present.
domain against your asset inventory. Anything you do not recognize — a vpn-test host, a forgotten staging subdomain, a certificate from an unexpected issuer — is a lead to investigate, and a notAfter date in the past flags a stale host that may still be reachable.