Certificates for the hostnames on an address
certificates_on_ipEvery 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>. archive_day lets get_certificate read one file for the full record.
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": {
"ip": "<ip>"
},
"name": "certificates_on_ip"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ip | Yes | A single IPv4 or IPv6 address. | |
| to | No | Last observation day, YYYY-MM-DD (UTC). Give with from. | |
| from | No | First observation day, YYYY-MM-DD (UTC). Give with to. | |
| after | No | The next_cursor from the previous call. | |
| limit | No | Certificates per page. | |
| order | No | By valid_from; asc (default) is oldest first. | |
| issuer | No | Only this issuer organization, e.g. "Let's Encrypt". | |
| wildcard | No | true: only certificates reaching a hostname through a wildcard SAN; false: only through an exact SAN. |