Certificate transparency and DNS history: certificates, past IPs, reverse IP and new domains.
Maintained byissued.live(verified)Also a maintainer?
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Every certificate issued for one public key, by the key's SHA-256 (spki_sha256 on a certificate). NEEDS AN API KEY ON THE PLUS PLAN OR ABOVE. Key reuse across certificates for unrelated names is a strong operator linkage. It searches only certificates first observed in the last 32 hours (the live table); archived certificates are not searched by key, and certificates ingested before 2026-09-07 carry no key hash. So a short answer can mean "not searched" rather than "not reused"; the reply's coverage field says so. Get the hash from get_certificate (spki_sha256). Returns up to 50 certificates; truncated true means there are more. To see one of them in full pass its cert_id to get_certificate.
The 64-hex SHA-256 of the certificate's SubjectPublicKeyInfo, exactly as get_certificate reports it in spki_sha256. Case does not matter. Not the certificate's own SHA-256, which identifies one certificate rather than its key.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http issued https://issued.live/mcp
Tool list last changed Nov 22, 2026.
Every certificate issued for one public key, by the key's SHA-256 (spki_sha256 on a certificate). NEEDS AN API KEY ON THE PLUS PLAN OR ABOVE. Key reuse across certificates for unrelated names is a strong operator linkage. It searches only certificates first observed in the last 32 hours (the live table); archived certificates are not searched by key, and certificates ingested before 2026-09-07 carry no key hash. So a short answer can mean "not searched" rather than "not reused"; the reply's coverage field says so. Get the hash from get_certificate (spki_sha256). Returns up to 50 certificates; truncated true means there are more. To see one of them in full pass its cert_id to get_certificate.
| Argument | Type | Description |
|---|---|---|
| spki_sha256* | string | The 64-hex SHA-256 of the certificate's SubjectPublicKeyInfo, exactly as get_certificate reports it in spki_sha256. Case does not matter. Not the certificate's own SHA-256, which identifies one certificate rather than its key. |
{
"type": "object",
"required": [
"spki_sha256"
],
"properties": {
"spki_sha256": {
"type": "string",
"description": "The 64-hex SHA-256 of the certificate's SubjectPublicKeyInfo, exactly as get_certificate reports it in spki_sha256. Case does not matter. Not the certificate's own SHA-256, which identifies one certificate rather than its key."
}
},
"additionalProperties": false
}Every certificate issued for the hostnames observed resolving to one IP address, in issuance order (valid_from). NEEDS AN API KEY ON THE PRO PLAN. A certificate qualifies when a SAN names one of the address's hostnames exactly, or is the wildcard one label above it. It is not "certificates whose SAN is the IP": IP-address SANs are not collected. The hostnames are every name ever seen on the address, so a shared host's tenants each bring their own certificates; co-location is not a relationship. from/to (YYYY-MM-DD, UTC, at most 15 days) is the window of FIRST OBSERVATION in CT, not of issuance; the default is the last 7 days. Each archived day searched costs one read per registrable domain on the address, so a busy address gets a narrower window: the reply's window, budget and coverage say what was searched, and coverage.unavailable_days what could not be. Addresses with more than 5000 hostnames (CDN, parking) are refused. issuer (exact organization, any case), wildcard and order narrow it; page with after=<next_cursor>. For an archived certificate, pass its cert_id and archive_day to get_certificate (as day) to read the full record from that one file. For the hostnames themselves rather than their certificates use domains_on_ip; for one domain's certificates use domain_detail.
| Argument | Type | Description |
|---|---|---|
| ip* | string | A single IPv4 or IPv6 address. |
| to | string | Last observation day, YYYY-MM-DD (UTC). Give with from. |
| from | string | First observation day, YYYY-MM-DD (UTC). Give with to. |
| after | string | The next_cursor from the previous call. |
How much this corpus holds and how fresh it is: total domains, certificates and log entries seen in the last 24 hours, DNS resolution coverage, CT log health, and the leading issuers and TLDs. Use this to calibrate a claim about coverage before making one — in particular, "domains_no_dns" is the count of domains for which no address has ever been resolved, and it is a large fraction of the corpus. Most of what certificate transparency shows has never resolved. as_of is when the figures were computed, which may be up to about ten minutes ago; the figures move by fractions of a percent over that interval. Free, no key, no arguments, and cheap: the figures are precomputed, so repeat calls return the same as_of until the next refresh. top_issuers and top_tlds are the ten largest. For one domain use lookup_domain; for what is being issued right now use recent_certificates.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Everything held for one domain in a single call: the record, registration timing, every address it has resolved to (each with the network behind it), and every certificate covering it with its SAN list. NEEDS AN API KEY ON THE PLUS PLAN OR ABOVE; lookup_domain is the free summary. Each address carries current (resolves there now) and network: ASN, organisation, announced range, country and reverse DNS, with network.status found, none or unavailable. "unavailable" means the enrichment could not be fetched this time, not that the address has no network; network_lookup counts how many of each. The same caution as lookup_domain applies to nulls: a null registration date is "not held", never "not registered". Accepts a hostname or a URL; a subdomain is answered for its registrable domain. A domain with no record returns a not-found result, which means not held, not unregistered. Choose it when you need the certificates or the networks behind the addresses; for many domains at once use lookup_domains, and for the dated order of events use domain_timeline.
| Argument | Type | Description |
|---|---|---|
| domain* | string | A domain name or a URL containing one, e.g. "github.com". |
{
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "A domain name or a URL containing one, e.g. \"github.com\"."
}
},
"additionalProperties": false
}The dated sequence of what has been observed for one domain, oldest first: when a zone file first listed it, certificates issued, when addresses were first observed, and DNS answer changes. NEEDS AN API KEY ON THE PLUS PLAN OR ABOVE. Use it when the ORDER and the gaps matter (registration to first certificate, certificate to first answer). Every event names its source and its precision (exact, day or observed), and gap_seconds is the time since the previous event. An event is when WE observed it, which bounds when it happened; it is not a registry's own timestamp. For the current state use lookup_domain (free) or domain_detail instead. One reply holds up to 2000 events, with no paging. Certificate events come only from the live certificate table, the last 32 hours (cert_window_days in the reply), so older issuance is not listed here; lookup_domain's first_cert_seen gives the first one. A domain with nothing observed returns a not-found result, which means nothing held, not an inactive domain.
| Argument | Type | Description |
|---|---|---|
| domain* | string | The registrable domain, e.g. "example.co.uk". A URL or a leading www. is accepted and stripped; other subdomains are not folded, so pass "example.co.uk", not "mail.example.co.uk". |
{
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "The registrable domain, e.g. \"example.co.uk\". A URL or a leading www. is accepted and stripped; other subdomains are not folded, so pass \"example.co.uk\", not \"mail.example.co.uk\"."
}
},
"additionalProperties": false
}Reverse lookup across a small CIDR range: which hostnames have been observed on any address in it. NEEDS AN API KEY ON THE PLUS PLAN OR ABOVE. THE RANGE IS CAPPED AT 256 ADDRESSES: an IPv4 /24 or narrower. Ask for /24s, and issue several calls rather than one wide one; a wider range is refused with a message, not truncated. For a single address use domains_on_ip. Paging works as in domains_on_ip: after="" starts a stable walk, then pass next_cursor back. The same caution as domains_on_ip applies more strongly here: names sharing a /24 usually share a hosting provider and nothing else.
| Argument | Type | Description |
|---|---|---|
| cidr* | string | A CIDR range covering at most 256 addresses, e.g. "8.8.8.0/24" or a narrower prefix. For one address use domains_on_ip. |
| after | string | Paging. Send an EMPTY string to start a stable walk in key order, then pass each reply's next_cursor back here. Omit it for the most recently seen names first, which cannot be paged. |
| limit | integer | Maximum hostnames to return. Default 500, maximum 50000; larger values are capped. |
| first_seen_to | string | Only hostnames first observed at or before this time, RFC3339 or YYYY-MM-DD, UTC. Pair with first_seen_from to isolate a provisioning window; either may be given alone. |
| first_seen_from | string | Only hostnames FIRST observed at this address at or after this time. RFC3339 or YYYY-MM-DD, UTC. It narrows the answer, not the work: use it to cut the number of pages. |
Reverse lookup: which hostnames have been observed resolving to one IP address. NEEDS AN API KEY ON THE PLUS PLAN OR ABOVE. Returns the hostname, its registrable domain, and when the pairing was first and last seen. A hosting or CDN address can carry a very long tail of unrelated names: co-location on an address is not evidence of a relationship between the domains, and should not be reported as one. last_seen is when the pairing was last confirmed. An old last_seen means the name has moved or stopped resolving, not that it still points here. A busy address holds more names than one reply: send after="" to walk all of them in stable order, passing each reply's next_cursor back as after. Accepts IPv4 and IPv6; for a range use domains_in_range, and for the certificates of the names on the address use certificates_on_ip. An address with no observed names returns count 0, which means none observed, not that the address is unused.
| Argument | Type | Description |
|---|---|---|
| ip* | string | A single IPv4 or IPv6 address, e.g. "157.240.17.8" or "2606:4700:4700::1111". Not a range or a hostname. |
| after | string | Paging. Send an EMPTY string to start a stable walk in key order, then pass each reply's next_cursor back here. Omit it for the most recently seen names first, which cannot be paged. |
| limit | integer | Maximum hostnames to return. Default 500, maximum 50000; larger values are capped. |
| first_seen_to | string | Only hostnames first observed at or before this time, RFC3339 or YYYY-MM-DD, UTC. Pair with first_seen_from to isolate a provisioning window; either may be given alone. |
One certificate by id: issuer, validity, key, and its full SAN list. NEEDS AN API KEY ON THE PLUS PLAN OR ABOVE. Takes the 32-hex cert_id that lookup_domain and domain_detail publish as ssl_cert, or a 64-hex certificate SHA-256. The SAN list of a shared certificate links names that a reverse proxy would otherwise hide from each other; it is a linkage, not proof of common ownership. Use it to open one certificate you already have an id for. To list certificates use domain_detail (one domain), certificates_on_ip (one address) or certificates_by_key (one public key, from this reply's spki_sha256). Live detail covers certificates first observed in the last 32 hours. On the Pro plan a miss falls through to the archived daily files: the last 7 days by default, or exactly the day given in day (certificates_on_ip reports it as archive_day). An id that matches nothing returns a not-found result naming which kind of id was searched; an id that is not 32 or 64 hex is rejected before any lookup.
| Argument | Type | Description |
|---|---|---|
| id* | string | A 32-hex cert_id (ssl_cert on a domain record, cert_id on other replies) or a 64-hex certificate SHA-256. Case does not matter. |
| day | string | Pro plan: the archived day to search, YYYY-MM-DD (UTC), e.g. the archive_day certificates_on_ip returned. Omit to search the live table, then the last 7 archived days. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "A 32-hex cert_id (ssl_cert on a domain record, cert_id on other replies) or a 64-hex certificate SHA-256. Case does not matter."
},
"day": {
"type": "string",
"description": "Pro plan: the archived day to search, YYYY-MM-DD (UTC), e.g. the archive_day certificates_on_ip returned. Omit to search the live table, then the last 7 archived days."
}
},
"additionalProperties": false
}The bulk dataset files your subscription can download right now: day, dataset, rows, bytes and SHA-256 for each. NEEDS A SUBSCRIBER KEY (any plan). This lists; it does not download. The files are large (a daily delta can be several GB), so fetch them over HTTPS with the same key: GET https://issued.live/api/v1/files/{day}/{name} with Authorization: Bearer <key>. Column-by-column descriptions are at https://issued.live/developers/files. The list is returned whole, with no paging. For a single domain or address the lookup tools are the cheaper route; the files are for bulk work.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}What 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. Free, no key. Use it for one domain's summary. With an API key: domain_detail for the full record (every certificate with its SAN list, the network behind each address), lookup_domains for many domains in one call, domain_timeline for the dated order of events, search_domains for names matching a pattern. A name with no record returns an error result saying none is held; the corpus covers names that have appeared in a certificate transparency log.
| Argument | Type | Description |
|---|---|---|
| domain* | string | A domain name or a URL containing one, e.g. "github.com" or "https://www.github.com/about". Subdomains are folded to the registrable domain. An IP address is refused; use domains_on_ip. |
{
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "A domain name or a URL containing one, e.g. \"github.com\" or \"https://www.github.com/about\". Subdomains are folded to the registrable domain. An IP address is refused; use domains_on_ip."
}
},
"additionalProperties": false
}Up to 500 domains in one call, answered in the order sent, each with status found, not_found or rejected. NEEDS AN API KEY ON THE PRO PLAN. include adds sub-lists to every found domain: addresses (the same address objects as domain_detail, with network), certificates, timing. Each one lowers the per-call domain cap because the reply is held in memory; the reply's limit says what applied. A sub-list whose query failed is named in include_failed, so an empty sub-list otherwise means none held. Use it for a list of known domains; for one domain the free lookup_domain (summary) or domain_detail (full record) is the better call, and for names you only know the shape of use search_domains. not_found means not held, never not registered; rejected means the input was not a valid domain.
| Argument | Type | Description |
|---|---|---|
| domains* | array | Domain names, up to 500, answered in the order sent. |
| include | array | Optional sub-lists for each found domain: addresses (with network), certificates, timing (registration timing). Omit for the summary record only; each one added lowers the per-call cap. |
{
"type": "object",
"required": [
"domains"
],
"properties": {
"domains": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 500,
"minItems": 1,
"description": "Domain names, up to 500, answered in the order sent."
},
"include": {
"type": "array",
"items": {
"enum": [
"addresses",
"certificates",
"timing"
],
"type": "string"
},
"description": "Optional sub-lists for each found domain: addresses (with network), certificates, timing (registration timing). Omit for the summary record only; each one added lowers the per-call cap."
}
},
"additionalProperties": false
}Newly registered domains from the ICANN zone-file feeds, oldest first from a cursor. NEEDS AN API KEY ON THE PRO PLAN. ASCENDING AND CURSOR-PAGED, which is what makes it safe to resume: pass the next_cursor from the previous call as "after" and you continue exactly where you stopped, with no gap, however long you were away. Omit "after" to start about 48 hours back. caught_up true means this page reached the end of what is available, not that the feed has ended: store next_cursor and call again later. since/until bound the window and tld narrows it to one TLD. Set certified true to restrict to newly registered domains that have SINCE been seen in a certificate, and max_hours_to_cert to how quickly: a domain registered and certified within a short window is a common pattern in phishing infrastructure. It is a pattern, not a finding; plenty of legitimate deployments look the same. For names matching a pattern use search_domains; for registration, certificate and first DNS answer clustering together use provisioning.
| Argument | Type | Description |
|---|---|---|
| tld | string | Only this TLD, e.g. "xyz". |
| after | string | The next_cursor from the previous call. Omit to start about 48 hours back. |
| limit | integer | Domains per page. Default 50, maximum 500. |
| since | string | Window start, RFC3339 or YYYY-MM-DD, UTC. |
| until | string | Window end, RFC3339 or YYYY-MM-DD, UTC. |
| certified |
Domains whose registration, first certificate and first DNS answer cluster inside a short window: the shape of infrastructure stood up in one go. NEEDS AN API KEY ON THE PRO PLAN. max_hours_to_cert bounds registration to certificate and cert_to_dns_max bounds certificate to first answer, both in hours. first_dns_answer is bounded by our own scan latency, so within 24 hours of registration only some candidates have one yet; the reply's coverage says how many. tld, ns, since and until narrow it; page with after=<next_cursor>. A tight cluster is a pattern, not a finding. Defaults: the last 72 hours, max_hours_to_cert 6 (ceiling 168), 100 rows per page (maximum 500). Each row gives domain, tld, first_zone_seen, first_cert_seen, first_dns_answer, dns_status, hours_zone_to_cert (negative when the certificate came first), hours_cert_to_dns, sequence, cert_id and ns. scanned above count means filters removed rows after the page was drawn, so a short page is not the end. For newly registered domains without the timing filter use new_domains.
| Argument | Type | Description |
|---|---|---|
| ns | string | Only domains delegated to this nameserver. |
| tld | string | Only this TLD, without the dot, e.g. "xyz". |
| after | string | The next_cursor from the previous call. |
| limit | integer | Rows per page. Default 100, maximum 500. |
| since | string | Window start, RFC3339 or YYYY-MM-DD, UTC. Default 72 hours back. |
Certificates as they were logged, newest first, from a rolling 30-minute window. This is a live tap, not a search: it answers "what is being issued right now", and there is no way to page backwards through it. A name that was logged an hour ago will not appear. To ask about a specific domain use lookup_domain instead. Free, no key. Returns at most limit entries from the window; a quiet window returns fewer, never an error. Each call is a fresh snapshot, so two calls a minute apart overlap. Each entry gives the issuer organisation, the first DNS name on the certificate, and how many names that certificate covers — a high name_count is a shared or wildcard certificate covering many hosts.
| Argument | Type | Description |
|---|---|---|
| limit | integer | How many certificates to return, newest first. Default 50 when omitted, maximum 500. |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "How many certificates to return, newest first. Default 50 when omitted, maximum 500."
}
},
"additionalProperties": false
}Registrable domains whose name matches a pattern, written forwards: *agent.com, loop-*.com, [a-z]{4,10}agent.com. NEEDS AN API KEY ON THE PRO PLAN. Naming the TLD makes the search a key range and about 60 times cheaper than a pattern that leaves it open. Every row carries its nameservers (ns) and cert_id; ns narrows the search to domains delegated to a nameserver. Page with after=<next_cursor>. A match is a name that fits the pattern, not evidence of intent: lookalike names are also registered defensively by the brands they resemble. Use it when you know the shape of a name but not the name. For one known domain use lookup_domain, for a list of known domains lookup_domains, and for names registered recently whatever their shape new_domains. No match returns count 0, not an error.
| Argument | Type | Description |
|---|---|---|
| ns | string | Only domains delegated to this nameserver hostname, e.g. "ns1.example.net". |
| name* | string | The pattern over the registrable domain, written forwards: * is any run of characters, [a-z]{4,10} a bounded class, e.g. "*agent.com" or "[a-z]{4,10}agent.com". End it with a literal TLD whenever you can; that is what keeps it cheap. |
| after | string | The next_cursor from the previous call. |
| limit | integer | Rows per page. Default 100, maximum 1000. |
{
"type": "object",
"required": [
"name"
],
"properties": {
"ns": {
"type": "string",
"description": "Only domains delegated to this nameserver hostname, e.g. \"ns1.example.net\"."
},
"name": {
"type": "string",
"description": "The pattern over the registrable domain, written forwards: * is any run of characters, [a-z]{4,10} a bounded class, e.g. \"*agent.com\" or \"[a-z]{4,10}agent.com\". End it with a literal TLD whenever you can; that is what keeps it cheap."
},
"after": {
"type": "string",
"description": "The next_cursor from the previous call."
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Rows per page. Default 100, maximum 1000."
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 22, 2026.
What changed in this server's tools since we started watching, newest first. Each change is scanned again.
The bulk dataset files your subscription can download right now: day, dataset, rows, bytes and SHA-256 for each. NEEDS A SUBSCRIBER KEY (any plan). This lists; it does not download. The files are large (a daily delta can be several GB), so fetch them over HTTPS with the same key: GET https://issued.live/api/v1/files/{day}/{name} with Authorization: Bearer <key>. Column-by-column descriptions are at https://issued.live/developers/files. The list is returned whole, with no paging. For a single domain or address the lookup tools are the cheaper route; the files are for bulk work.
Every certificate issued for the hostnames observed resolving to one IP address, in issuance order (valid_from). NEEDS AN API KEY ON THE PRO PLAN. A certificate qualifies when a SAN names one of the address's hostnames exactly, or is the wildcard one label above it. It is not "certificates whose SAN is the IP": IP-address SANs are not collected. The hostnames are every name ever seen on the address, so a shared host's tenants each bring their own certificates; co-location is not a relationship. from/to (YYYY-MM-DD, UTC, at most 15 days) is the window of FIRST OBSERVATION in CT, not of issuance; the default is the last 7 days. Each archived day searched costs one read per registrable domain on the address, so a busy address gets a narrower window: the reply's window, budget and coverage say what was searched, and coverage.unavailable_days what could not be. Addresses with more than 5000 hostnames (CDN, parking) are refused. issuer (exact organization, any case), wildcard and order narrow it; page with after=<next_cursor>. For an archived certificate,archive_day get_certificate read one for
Domains whose registration, first certificate and first DNS answer cluster inside a short window: the shape of infrastructure stood up in one go. NEEDS AN API KEY ON THE PRO PLAN. max_hours_to_cert bounds registration to certificate and cert_to_dns_max bounds certificate to first answer, both in hours. first_dns_answer is bounded by our own scan latency, so within 24 hours of registration only some candidates have one yet; the reply's coverage says how many. tld, ns, since and until narrow it; page with after=<next_cursor>. A tight cluster is a pattern, not a finding. Defaults: the last 72 hours, max_hours_to_cert 6
Up to 500 domains in one call, answered in the order sent, each with status found, not_found or rejected. NEEDS AN API KEY ON THE PRO PLAN. include adds sub-lists to every found domain: addresses (the same address objects as domain_detail, with network), certificates, timing. Each one lowers the per-call domain cap because the reply is held in memory; the reply's limit says what applied. A sub-list whose query failed is named in include_failed, so an empty sub-list otherwise means none held. Use it for a list of known domains;
Registrable domains whose name matches a pattern, written forwards: *agent.com, loop-*.com, [a-z]{4,10}agent.com. NEEDS AN API KEY ON THE PRO PLAN. Naming the TLD makes the search a key range and about 60 times cheaper than a pattern that leaves it open. Every row carries its nameservers (ns) and cert_id; ns narrows the search to domains delegated to a nameserver. Page with after=<next_cursor>. A match is a name that fits the pattern, not evidence of intent: lookalike names are also registered defensively by the brands they resemble. Use it when you know the shape
Newly registered domains from the ICANN zone-file feeds, oldest first from a cursor. NEEDS AN API KEY ON THE PRO PLAN. ASCENDING AND CURSOR-PAGED, which is what makes it safe to resume: pass the next_cursor from the previous call as "after" and you continue exactly where you stopped, with no gap, however long you were away. Omit "after" to start about 48 hours back. caught_up true means this page reached the end of what is available, not that the feed has ended: store next_cursor and call again later. since/until bound the window and tld narrows it to one TLD. Set certified true to restrict to newly registered domains that have SINCE been seen in a certificate, and max_hours_to_cert to how quickly: a domain registered and certified within a short window is a common pattern in phishing infrastructure. It is a pattern, not a finding; plenty of legitimate deployments look the same. For names matching a
The dated sequence of what has been observed for one domain:domain, oldest first: when a zone file first listed it, eachcertificates certificate,issued, thewhen addresses were first DNSobserved, answer,and addressDNS changes. NEEDS AN API KEY ON THE PLUS PLAN OR ABOVE.
Every event names its source and its is the An event is when WE observed it, which bounds when it happened; it is not a registry's own timestamp.
Every certificate issued for one public key, by the key's SHA-256 (spki_sha256 on a certificate). NEEDS AN API KEY ON THE PLUS PLAN OR ABOVE. Key reuse across certificates for unrelated names is a strong operator linkage. It searches only certificates first observed in the last 32 hours (the live table); archived certificates are not searched by key, and certificates ingested before 2026-09-07 carry no key hash. So a short answer can mean "not searched" rather than "not reused"; the reply's coverage field says so. Get the hash from get_certificate (spki_sha256). Returns
One certificate by id: issuer, validity, key, and its full SAN list. NEEDS AN API KEY ON THE PLUS PLAN OR ABOVE. Takes the 32-hex cert_id that lookup_domain and domain_detail publish as ssl_cert, or a 64-hex certificate SHA-256. The SAN list of a shared certificate links names that a reverse proxy would otherwise hide from each other; it is a linkage, not proof of common ownership. Use it to open one certificate you already have
Reverse lookup across a small CIDR range: which hostnames have been observed on any address in it. NEEDS AN API KEY ON THE PLUS PLAN OR ABOVE.
THE RANGE IS CAPPED AT 256 ADDRESSES: an IPv4 /24 or narrower. Ask for /24s, and issue several calls rather than one wide one.one; a wider range is refused with a message, notPaging works as in
The same caution as domains_on_ip applies more strongly here: names sharing a /24 usually share a hosting provider and nothing else.
Reverse lookup: which hostnames have been observed resolving to one IP address. NEEDS AN API KEY ON THE PLUS PLAN OR ABOVE.
Returns the hostname, its registrable domain, and when the pairing was first and last seen. A hosting or CDN address can carry a very long tail of unrelated names: co-location on an address is not evidence of a relationship between the domains, and should not be reported as one.
last_seen is when the pairing was last confirmed. An old last_seen means the name has moved or stopped resolving, not that it still points here.
A busy address holds more names than one reply: send after="" to walk all of them in stable order, passing each reply's next_cursor back as after. Accepts IPv4 and IPv6; for a range use domains_in_range.domains_in_range, and for the certificates
Everything held for one domain in a single call: the record, registration timing, every address it has resolved to (each with the network behind it), and every certificate covering it with its SAN list. NEEDS AN API KEY ON THE PLUS PLAN OR ABOVE; lookup_domain is the free summary. Each address carries current (resolves there now) and network: ASN, organisation, announced range, country and reverse DNS, with network.status found, none or unavailable. "unavailable" means the enrichment could not be fetched this time, not that the address has no network; network_lookup counts how many of each. The same caution as lookup_domain applies to nulls: a null registration date is "not held", never "not registered". Accepts a hostname or a URL; a subdomain is answered for its registrable domain. A domain with no record
How much this corpus holds and how fresh it is: total domains, certificates and log entries seen in the last 24 hours, DNS resolution coverage, CT log health, and the leading issuers and TLDs. Use this to calibrate a claim about coverage before making one — in particular, "domains_no_dns" is the count of domains for which no address has ever been resolved, and it is a large fraction of the corpus. Most of what certificate transparency shows has never resolved. as_of is when the figures were computed, which may be up to about ten minutes ago; the figures move by fractions of a percent over that interval. Free, no key, no arguments, and cheap:
Certificates as they were logged, newest first, from a rolling 30-minute window. This is a live tap, not a search: it answers "what is being issued right now", and there is no way to page backwards through it. A name that was logged an hour ago will not appear. To ask about a specific domain use lookup_domain instead. Free, no key. Returns at most limit entries from Each entry gives the issuer organisation, the first DNS name on the certificate, and how many names that certificate covers — a high name_count is a shared or wildcard certificate covering many hosts.
What 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. Free, no key.
| limit | integer | Certificates per page. Default 100, maximum 500. |
| order | string | By valid_from; asc (default) is oldest first. |
| issuer | string | Only this issuer organization, e.g. "Let's Encrypt". |
| wildcard | boolean | true: only certificates reaching a hostname through a wildcard SAN; false: only through an exact SAN. |
{
"type": "object",
"required": [
"ip"
],
"properties": {
"ip": {
"type": "string",
"description": "A single IPv4 or IPv6 address."
},
"to": {
"type": "string",
"description": "Last observation day, YYYY-MM-DD (UTC). Give with from."
},
"from": {
"type": "string",
"description": "First observation day, YYYY-MM-DD (UTC). Give with to."
},
"after": {
"type": "string",
"description": "The next_cursor from the previous call."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Certificates per page. Default 100, maximum 500."
},
"order": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "By valid_from; asc (default) is oldest first."
},
"issuer": {
"type": "string",
"description": "Only this issuer organization, e.g. \"Let's Encrypt\"."
},
"wildcard": {
"type": "boolean",
"description": "true: only certificates reaching a hostname through a wildcard SAN; false: only through an exact SAN."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"cidr"
],
"properties": {
"cidr": {
"type": "string",
"description": "A CIDR range covering at most 256 addresses, e.g. \"8.8.8.0/24\" or a narrower prefix. For one address use domains_on_ip."
},
"after": {
"type": "string",
"description": "Paging. Send an EMPTY string to start a stable walk in key order, then pass each reply's next_cursor back here. Omit it for the most recently seen names first, which cannot be paged."
},
"limit": {
"type": "integer",
"maximum": 50000,
"minimum": 1,
"description": "Maximum hostnames to return. Default 500, maximum 50000; larger values are capped."
},
"first_seen_to": {
"type": "string",
"description": "Only hostnames first observed at or before this time, RFC3339 or YYYY-MM-DD, UTC. Pair with first_seen_from to isolate a provisioning window; either may be given alone."
},
"first_seen_from": {
"type": "string",
"description": "Only hostnames FIRST observed at this address at or after this time. RFC3339 or YYYY-MM-DD, UTC. It narrows the answer, not the work: use it to cut the number of pages."
}
},
"additionalProperties": false
}| first_seen_from | string | Only hostnames FIRST observed at this address at or after this time. RFC3339 or YYYY-MM-DD, UTC. It narrows the answer, not the work: use it to cut the number of pages. |
{
"type": "object",
"required": [
"ip"
],
"properties": {
"ip": {
"type": "string",
"description": "A single IPv4 or IPv6 address, e.g. \"157.240.17.8\" or \"2606:4700:4700::1111\". Not a range or a hostname."
},
"after": {
"type": "string",
"description": "Paging. Send an EMPTY string to start a stable walk in key order, then pass each reply's next_cursor back here. Omit it for the most recently seen names first, which cannot be paged."
},
"limit": {
"type": "integer",
"maximum": 50000,
"minimum": 1,
"description": "Maximum hostnames to return. Default 500, maximum 50000; larger values are capped."
},
"first_seen_to": {
"type": "string",
"description": "Only hostnames first observed at or before this time, RFC3339 or YYYY-MM-DD, UTC. Pair with first_seen_from to isolate a provisioning window; either may be given alone."
},
"first_seen_from": {
"type": "string",
"description": "Only hostnames FIRST observed at this address at or after this time. RFC3339 or YYYY-MM-DD, UTC. It narrows the answer, not the work: use it to cut the number of pages."
}
},
"additionalProperties": false
}| boolean |
| Only newly registered domains that have since appeared in a certificate. |
| max_hours_to_cert | number | With certified: only domains certified within this many hours of registration. |
{
"type": "object",
"properties": {
"tld": {
"type": "string",
"description": "Only this TLD, e.g. \"xyz\"."
},
"after": {
"type": "string",
"description": "The next_cursor from the previous call. Omit to start about 48 hours back."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Domains per page. Default 50, maximum 500."
},
"since": {
"type": "string",
"description": "Window start, RFC3339 or YYYY-MM-DD, UTC."
},
"until": {
"type": "string",
"description": "Window end, RFC3339 or YYYY-MM-DD, UTC."
},
"certified": {
"type": "boolean",
"description": "Only newly registered domains that have since appeared in a certificate."
},
"max_hours_to_cert": {
"type": "number",
"description": "With certified: only domains certified within this many hours of registration."
}
},
"additionalProperties": false
}| until |
| string |
| Window end, RFC3339 or YYYY-MM-DD, UTC. Default now. |
| cert_to_dns_max | number | First certificate to first DNS answer, at most this many hours. |
| max_hours_to_cert | number | Registration to first certificate, at most this many hours. Default 6, maximum 168. |
| include_cert_before_zone | boolean | Also include domains certified BEFORE a zone file listed them (sequence cert_before_zone). Default false. |
{
"type": "object",
"properties": {
"ns": {
"type": "string",
"description": "Only domains delegated to this nameserver."
},
"tld": {
"type": "string",
"description": "Only this TLD, without the dot, e.g. \"xyz\"."
},
"after": {
"type": "string",
"description": "The next_cursor from the previous call."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Rows per page. Default 100, maximum 500."
},
"since": {
"type": "string",
"description": "Window start, RFC3339 or YYYY-MM-DD, UTC. Default 72 hours back."
},
"until": {
"type": "string",
"description": "Window end, RFC3339 or YYYY-MM-DD, UTC. Default now."
},
"cert_to_dns_max": {
"type": "number",
"description": "First certificate to first DNS answer, at most this many hours."
},
"max_hours_to_cert": {
"type": "number",
"description": "Registration to first certificate, at most this many hours. Default 6, maximum 168."
},
"include_cert_before_zone": {
"type": "boolean",
"description": "Also include domains certified BEFORE a zone file listed them (sequence cert_before_zone). Default false."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ip"
],
"properties": {
"ip": {
"type": "string",
"description": "A single IPv4 or IPv6 address."
},
"to": {
"type": "string",
"description": "Last observation day, YYYY-MM-DD (UTC). Give with from."
},
"from": {
"type": "string",
"description": "First observation day, YYYY-MM-DD (UTC). Give with to."
},
"after": {
"type": "string",
"description": "The next_cursor from the previous call."
},
"limit": {
"type": "integer",
"minimum": 1,
"description": "Certificates per page."
},
"order": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "By valid_from; asc (default) is oldest first."
},
"issuer": {
"type": "string",
"description": "Only this issuer organization, e.g. \"Let's Encrypt\"."
},
"wildcard": {
"type": "boolean",
"description": "true: only certificates reaching a hostname through a wildcard SAN; false: only through an exact SAN."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ip"
],
"properties": {
"ip": {
"type": "string",
"description": "A single IPv4 or IPv6 address."
},
"to": {
"type": "string",
"description": "Last observation day, YYYY-MM-DD (UTC). Give with from."
},
"from": {
"type": "string",
"description": "First observation day, YYYY-MM-DD (UTC). Give with to."
},
"after": {
"type": "string",
"description": "The next_cursor from the previous call."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Certificates per page. Default 100, maximum 500."
},
"order": {
"enum": [
"asc",
"desc"
],
"type": "string",
"description": "By valid_from; asc (default) is oldest first."
},
"issuer": {
"type": "string",
"description": "Only this issuer organization, e.g. \"Let's Encrypt\"."
},
"wildcard": {
"type": "boolean",
"description": "true: only certificates reaching a hostname through a wildcard SAN; false: only through an exact SAN."
}
},
"additionalProperties": false
}{
"type": "object",
"properties": {
"ns": {
"type": "string",
"description": "Only domains delegated to this nameserver."
},
"tld": {
"type": "string",
"description": "Only this TLD."
},
"after": {
"type": "string",
"description": "The next_cursor from the previous call."
},
"limit": {
"type": "integer",
"minimum": 1,
"description": "Rows per page."
},
"since": {
"type": "string",
"description": "Window start, RFC3339 or YYYY-MM-DD, UTC."
},
"until": {
"type": "string",
"description": "Window end, RFC3339 or YYYY-MM-DD, UTC."
},
"cert_to_dns_max": {
"type": "number",
"description": "First certificate to first DNS answer, at most this many hours."
},
"max_hours_to_cert": {
"type": "number",
"description": "Registration to first certificate, at most this many hours."
},
"include_cert_before_zone": {
"type": "boolean",
"description": "Also include domains certified BEFORE a zone file listed them."
}
},
"additionalProperties": false
}{
"type": "object",
"properties": {
"ns": {
"type": "string",
"description": "Only domains delegated to this nameserver."
},
"tld": {
"type": "string",
"description": "Only this TLD, without the dot, e.g. \"xyz\"."
},
"after": {
"type": "string",
"description": "The next_cursor from the previous call."
},
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "Rows per page. Default 100, maximum 500."
},
"since": {
"type": "string",
"description": "Window start, RFC3339 or YYYY-MM-DD, UTC. Default 72 hours back."
},
"until": {
"type": "string",
"description": "Window end, RFC3339 or YYYY-MM-DD, UTC. Default now."
},
"cert_to_dns_max": {
"type": "number",
"description": "First certificate to first DNS answer, at most this many hours."
},
"max_hours_to_cert": {
"type": "number",
"description": "Registration to first certificate, at most this many hours. Default 6, maximum 168."
},
"include_cert_before_zone": {
"type": "boolean",
"description": "Also include domains certified BEFORE a zone file listed them (sequence cert_before_zone). Default false."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"domains"
],
"properties": {
"domains": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 500,
"minItems": 1,
"description": "Domain names, up to 500."
},
"include": {
"type": "array",
"items": {
"enum": [
"addresses",
"certificates",
"timing"
],
"type": "string"
},
"description": "Optional sub-lists for each found domain."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"domains"
],
"properties": {
"domains": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 500,
"minItems": 1,
"description": "Domain names, up to 500, answered in the order sent."
},
"include": {
"type": "array",
"items": {
"enum": [
"addresses",
"certificates",
"timing"
],
"type": "string"
},
"description": "Optional sub-lists for each found domain: addresses (with network), certificates, timing (registration timing). Omit for the summary record only; each one added lowers the per-call cap."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"name"
],
"properties": {
"ns": {
"type": "string",
"description": "Only domains delegated to this nameserver."
},
"name": {
"type": "string",
"description": "The pattern, e.g. \"*agent.com\" or \"[a-z]{4,10}agent.com\"."
},
"after": {
"type": "string",
"description": "The next_cursor from the previous call."
},
"limit": {
"type": "integer",
"minimum": 1,
"description": "Rows per page."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"name"
],
"properties": {
"ns": {
"type": "string",
"description": "Only domains delegated to this nameserver hostname, e.g. \"ns1.example.net\"."
},
"name": {
"type": "string",
"description": "The pattern over the registrable domain, written forwards: * is any run of characters, [a-z]{4,10} a bounded class, e.g. \"*agent.com\" or \"[a-z]{4,10}agent.com\". End it with a literal TLD whenever you can; that is what keeps it cheap."
},
"after": {
"type": "string",
"description": "The next_cursor from the previous call."
},
"limit": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Rows per page. Default 100, maximum 1000."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "A domain name or a URL containing one."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "The registrable domain, e.g. \"example.co.uk\". A URL or a leading www. is accepted and stripped; other subdomains are not folded, so pass \"example.co.uk\", not \"mail.example.co.uk\"."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"spki_sha256"
],
"properties": {
"spki_sha256": {
"type": "string",
"description": "The 64-hex SHA-256 of the SubjectPublicKeyInfo, as get_certificate reports it."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"spki_sha256"
],
"properties": {
"spki_sha256": {
"type": "string",
"description": "The 64-hex SHA-256 of the certificate's SubjectPublicKeyInfo, exactly as get_certificate reports it in spki_sha256. Case does not matter. Not the certificate's own SHA-256, which identifies one certificate rather than its key."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "A 32-hex cert_id (ssl_cert on a domain record) or a 64-hex certificate SHA-256."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "A 32-hex cert_id (ssl_cert on a domain record, cert_id on other replies) or a 64-hex certificate SHA-256. Case does not matter."
},
"day": {
"type": "string",
"description": "Pro plan: the archived day to search, YYYY-MM-DD (UTC), e.g. the archive_day certificates_on_ip returned. Omit to search the live table, then the last 7 archived days."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"cidr"
],
"properties": {
"cidr": {
"type": "string",
"description": "A CIDR range covering at most 256 addresses, e.g. \"8.8.8.0/24\"."
},
"after": {
"type": "string",
"description": "Paging. Send an EMPTY string to start a stable walk in key order, then pass each reply's next_cursor back here. Omit it for the most recently seen names first, which cannot be paged."
},
"limit": {
"type": "integer",
"maximum": 50000,
"minimum": 1,
"description": "Maximum hostnames to return. Default 500, maximum 50000."
},
"first_seen_to": {
"type": "string",
"description": "Only hostnames first observed at or before this time. Pair with first_seen_from to isolate a provisioning window."
},
"first_seen_from": {
"type": "string",
"description": "Only hostnames FIRST observed at this address at or after this time. RFC3339 or YYYY-MM-DD, UTC. It narrows the answer, not the work: use it to cut the number of pages."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"cidr"
],
"properties": {
"cidr": {
"type": "string",
"description": "A CIDR range covering at most 256 addresses, e.g. \"8.8.8.0/24\" or a narrower prefix. For one address use domains_on_ip."
},
"after": {
"type": "string",
"description": "Paging. Send an EMPTY string to start a stable walk in key order, then pass each reply's next_cursor back here. Omit it for the most recently seen names first, which cannot be paged."
},
"limit": {
"type": "integer",
"maximum": 50000,
"minimum": 1,
"description": "Maximum hostnames to return. Default 500, maximum 50000; larger values are capped."
},
"first_seen_to": {
"type": "string",
"description": "Only hostnames first observed at or before this time, RFC3339 or YYYY-MM-DD, UTC. Pair with first_seen_from to isolate a provisioning window; either may be given alone."
},
"first_seen_from": {
"type": "string",
"description": "Only hostnames FIRST observed at this address at or after this time. RFC3339 or YYYY-MM-DD, UTC. It narrows the answer, not the work: use it to cut the number of pages."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ip"
],
"properties": {
"ip": {
"type": "string",
"description": "A single IPv4 or IPv6 address, e.g. \"157.240.17.8\"."
},
"after": {
"type": "string",
"description": "Paging. Send an EMPTY string to start a stable walk in key order, then pass each reply's next_cursor back here. Omit it for the most recently seen names first, which cannot be paged."
},
"limit": {
"type": "integer",
"maximum": 50000,
"minimum": 1,
"description": "Maximum hostnames to return. Default 500, maximum 50000."
},
"first_seen_to": {
"type": "string",
"description": "Only hostnames first observed at or before this time. Pair with first_seen_from to isolate a provisioning window."
},
"first_seen_from": {
"type": "string",
"description": "Only hostnames FIRST observed at this address at or after this time. RFC3339 or YYYY-MM-DD, UTC. It narrows the answer, not the work: use it to cut the number of pages."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"ip"
],
"properties": {
"ip": {
"type": "string",
"description": "A single IPv4 or IPv6 address, e.g. \"157.240.17.8\" or \"2606:4700:4700::1111\". Not a range or a hostname."
},
"after": {
"type": "string",
"description": "Paging. Send an EMPTY string to start a stable walk in key order, then pass each reply's next_cursor back here. Omit it for the most recently seen names first, which cannot be paged."
},
"limit": {
"type": "integer",
"maximum": 50000,
"minimum": 1,
"description": "Maximum hostnames to return. Default 500, maximum 50000; larger values are capped."
},
"first_seen_to": {
"type": "string",
"description": "Only hostnames first observed at or before this time, RFC3339 or YYYY-MM-DD, UTC. Pair with first_seen_from to isolate a provisioning window; either may be given alone."
},
"first_seen_from": {
"type": "string",
"description": "Only hostnames FIRST observed at this address at or after this time. RFC3339 or YYYY-MM-DD, UTC. It narrows the answer, not the work: use it to cut the number of pages."
}
},
"additionalProperties": false
}{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "How many certificates to return. Default 50, maximum 500."
}
},
"additionalProperties": false
}{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"maximum": 500,
"minimum": 1,
"description": "How many certificates to return, newest first. Default 50 when omitted, maximum 500."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "A domain name or a URL containing one, e.g. \"github.com\" or \"https://www.github.com/about\"."
}
},
"additionalProperties": false
}{
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string",
"description": "A domain name or a URL containing one, e.g. \"github.com\" or \"https://www.github.com/about\". Subdomains are folded to the registrable domain. An IP address is refused; use domains_on_ip."
}
},
"additionalProperties": false
}