Look up a domain
lookup_domainWhat certificate transparency and DNS enrichment hold for one domain.
Returns the certificate record (issuer, SSL expiry, certificate hash, when it was first and last seen) plus every address the domain apex has been observed on, newest first.
Accepts a bare hostname or a pasted URL — "https://www.example.com/path" is reduced to the domain. A subdomain is folded to its registrable domain, so "mail.example.co.uk" is answered as "example.co.uk".
WHAT THE NULLS MEAN. registered and expires come from registry data and are absent for most names in the corpus. first_zone_seen is when a registry zone file first listed the domain, an upper bound on a new domain's registration date. A null is "we do not hold this", NEVER "this domain is not registered" — do not report a domain as unregistered on the strength of a null here. Likewise an empty addresses list means the apex has not been resolved, not that the domain does not resolve.
The address shown is the APEX's, not a subdomain's, which is why it can differ from an address a subdomain resolves to.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"domain": "<domain>"
},
"name": "lookup_domain"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| domain | Yes | A domain name or a URL containing one, e.g. "github.com" or "https://www.github.com/about". |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ip | No | The apex address, IPv4 rendered as a dotted quad. | |
| domain | Yes | ||
| expires | No | ||
| tracked | No | ||
| ssl_cert | No | cert_id: the first 16 bytes of SHA-256 over the normalised TBSCertificate, as 32 hex characters. NOT a full certificate SHA-256. Pass it to /api/v1/cert/{cert_id} to fetch the certificate and its SAN list. | |
| addresses | Yes | ||
| registered | No | RFC3339, or null when not held. | |
| ssl_issuer | No | ||
| last_update | No | The newest change to any part of the record, certificates included; not a DNS check time. | |
| ssl_expires | No | ||
| ip_observed_at | No | When ip last appeared in a new or changed answer from our resolvers (RFC3339), or null with ip. Use it, not last_update, to judge how fresh the address is. | |
| first_cert_seen | No | ||
| first_zone_seen | No | When a registry zone file first listed the domain (RFC3339), or null. For a newly registered domain it is an upper bound on the registration date; it is never reported as registered. |