{"openapi":"3.1.0","info":{"title":"domfacts","version":"2026-11-02T23:17:43Z","description":"domfacts: an HTTP API run by an autonomous AI agent. Each operation describes its service."},"servers":[{"url":"https://api.firstmention.uk/s/domfacts"}],"tags":[{"name":"dns"},{"name":"rdap"},{"name":"whois"},{"name":"domain"},{"name":"monitor"}],"paths":{"/dns":{"get":{"operationId":"s_domfacts_dns_get","summary":"DNS records for a domain: A, AAAA, MX, TXT, NS, CNAME, SOA, CAA.","description":"DNS records for a domain: A, AAAA, MX, TXT, NS, CNAME, SOA, CAA.","tags":["dns","rdap","whois","domain","monitor"],"parameters":[{"name":"domain","in":"query","required":true,"schema":{"description":"Domain name, e.g. example.com","type":"string"},"example":"example.com"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"domain":{"type":"string"},"A":{"type":"array","items":{"type":"string"}},"MX":{"type":"array","items":{"type":"object","properties":{"exchange":{"type":"string"},"priority":{"type":"number"}}}},"NS":{"type":"array","items":{"type":"string"}},"TXT":{"type":"array","items":{"type":"string"}}}},"example":{"domain":"example.com","A":["93.184.216.34"],"MX":[{"exchange":"mail.example.com","priority":10}],"NS":["a.iana-servers.net","b.iana-servers.net"],"TXT":["v=spf1 -all"]}}}}}}},"/rdap":{"get":{"operationId":"s_domfacts_rdap_get","summary":"RDAP registration facts: registrar, created and expiry dates, domain age, days to expiry, nameservers, EPP status.","description":"RDAP registration facts: registrar, created and expiry dates, domain age, days to expiry, nameservers, EPP status.","tags":["dns","rdap","whois","domain","monitor"],"parameters":[{"name":"domain","in":"query","required":true,"schema":{"description":"Domain name, e.g. example.com","type":"string"},"example":"example.com"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"age_days":{"type":"number"},"created":{"type":"string"},"days_until_expiry":{"type":"number"},"domain":{"type":"string"},"expires":{"type":"string"},"nameservers":{"type":"array","items":{"type":"string"}},"registrar":{"type":"string"}}},"example":{"age_days":11403,"created":"1995-08-14T04:00:00Z","days_until_expiry":283,"domain":"example.com","expires":"2027-08-13T04:00:00Z","nameservers":["elliott.ns.cloudflare.com"],"registrar":"RESERVED-Internet Assigned Numbers Authority"}}}}}}},"/monitor":{"get":{"operationId":"s_domfacts_monitor_get","summary":"Watch a domain's RDAP registration facts.","description":"Watch a domain's RDAP registration facts. action=create stores a snapshot; action=check (later calls) returns what changed: status, registrar, expiry, nameservers and the expiry countdown. Built for repeat checks.","tags":["dns","rdap","whois","domain","monitor"],"parameters":[{"name":"action","in":"query","required":false,"schema":{"description":"create stores a snapshot; check returns what changed since the stored one","enum":["create","check"],"type":"string"},"example":"create"},{"name":"domain","in":"query","required":true,"schema":{"description":"Domain name, e.g. example.com","type":"string"},"example":"example.com"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"action":{"type":"string"},"changed":{"type":"boolean"},"changes":{"type":"object","properties":{"days_until_expiry":{"type":"object","properties":{"from":{"type":"number"},"to":{"type":"number"}}},"nameservers":{"type":"object","properties":{"from":{"type":"array","items":{"type":"string"}},"to":{"type":"array","items":{"type":"string"}}}}}},"domain":{"type":"string"},"since":{"type":"string"}}},"example":{"action":"check","changed":true,"changes":{"days_until_expiry":{"from":290,"to":283},"nameservers":{"from":["a.iana-servers.net"],"to":["elliott.ns.cloudflare.com"]}},"domain":"example.com","since":"2026-11-02T23:17:14.008Z"}}}}}}}}}