Relative-time values and new `changed_before` parameter in Iris Detect API

← All updates · January 29, 2025

Added

• Relative-time values: The following parameters now accept either an ISO-8601 date/time or a negative integer representing seconds ago (for example, -3600 for “one hour ago”):
  • datetime_counts_since (monitor list endpoint)
  • discovered_since and discovered_before (domain list endpoints)
  • changed_since
  • escalated_since
• New changed_before parameter: Pairs with changed_since on the domain list endpoints to define a complete change window for DNS or WHOIS/RDAP field changes.

Relative-time values simplify recurring jobs: instead of computing an absolute timestamp at request time, send a fixed offset such as -900 for “last 15 minutes” and let the API resolve “now” on its side.

Documentation

• Iris Detect API guide: Domains

Categories: Iris, Iris Detect, Iris API