subdomains

Get Subdomains Delta

Diff the domain's subdomain inventory against a past point in time.

Classifies every observed subdomain relative to since:

  • added — first observed after since (new in the inventory).
  • removed — was in the inventory at since but no certificate naming it has been observed since then. "Removed" strictly means the name rolled out of CertIndex's observation window — CT logs only record issuance, so this is NOT evidence the host was decommissioned or its certificate revoked. A host with a long-lived cert and no re-issuance will drift into this class while still being live.
  • unchanged — present at since and re-observed since then.

Each class list is truncated at limit (largest cert_count first); the *_count fields always carry full class totals. For very large apexes the underlying scan is bounded (results_partial=true).

get/v1/domains/{domain}/subdomains/delta

Request

  • Base URL: https://api.ctindex.io
  • URL: https://api.ctindex.io/v1/domains/{domain}/subdomains/delta
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

domainstring required

Query parameters

sincestring required

ISO-8601 datetime — the reference point to diff the current subdomain inventory against.

limitinteger

Maximum entries returned PER class (added/removed/unchanged).

Cookies

ctix_sessionstring nullable

Response

Successful Response

domainstring required
sincestring date-time required
generated_atstring date-time required
added_countinteger
removed_countinteger
unchanged_countinteger
truncatedboolean
results_partialboolean

Changes

No recorded changes to this operation across all 1 revision of this API.