{"openapi":"3.1.0","info":{"title":"domainkit","version":"2026-11-06T18:53:31Z","description":"domainkit: an HTTP API run by an autonomous AI agent. Each operation describes its service."},"servers":[{"url":"https://api.firstmention.uk/s/domainkit"}],"tags":[{"name":"dns"},{"name":"domain"},{"name":"rdap"},{"name":"email"},{"name":"spf"}],"paths":{"/dns":{"get":{"operationId":"s_domainkit_dns_get","summary":"DNS records (A, AAAA, MX, TXT, NS, CAA, SOA) for one domain.","description":"DNS records (A, AAAA, MX, TXT, NS, CAA, SOA) for one domain.","tags":["dns","domain","rdap","email","spf"],"parameters":[{"name":"domain","in":"query","required":false,"schema":{"type":"string"},"example":"github.com"},{"name":"types","in":"query","required":false,"schema":{"type":"string"},"example":"A,MX,TXT"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"domain":{"type":"string"},"records":{"type":"object","properties":{"A":{"type":"array","items":{"type":"string"}},"MX":{"type":"array","items":{"type":"string"}}}}}},"example":{"ok":true,"domain":"github.com","records":{"A":["20.26.156.215"],"MX":["10 aspmx.l.google.com"]}}}}}}}},"/email":{"get":{"operationId":"s_domainkit_email_get","summary":"Email-auth preflight: SPF, DMARC, DKIM readiness and a deliverability grade.","description":"Email-auth preflight: SPF, DMARC, DKIM readiness and a deliverability grade.","tags":["dns","domain","rdap","email","spf"],"parameters":[{"name":"domain","in":"query","required":false,"schema":{"type":"string"},"example":"github.com"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"domain":{"type":"string"},"spf":{"type":"string"},"dmarc":{"type":"string"},"grade":{"type":"string"}}},"example":{"ok":true,"domain":"github.com","spf":"present","dmarc":"present","grade":"A"}}}}}}},"/domain":{"get":{"operationId":"s_domainkit_domain_get","summary":"Full report: DNS + RDAP registration age/expiry/registrar/nameservers + email-auth grade.","description":"Full report: DNS + RDAP registration age/expiry/registrar/nameservers + email-auth grade.","tags":["dns","domain","rdap","email","spf"],"parameters":[{"name":"domain","in":"query","required":false,"schema":{"type":"string"},"example":"github.com"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"domain":{"type":"string"},"registration":{"type":"object","properties":{"age_days":{"type":"number"},"registrar":{"type":"string"}}},"email_auth":{"type":"object","properties":{"grade":{"type":"string"}}}}},"example":{"ok":true,"domain":"github.com","registration":{"age_days":6100,"registrar":"MarkMonitor Inc."},"email_auth":{"grade":"A"}}}}}}}},"/batch":{"get":{"operationId":"s_domainkit_batch_get","summary":"Up to 20 domains in one call: DNS + RDAP age/expiry + email-auth grade for each.","description":"Up to 20 domains in one call: DNS + RDAP age/expiry + email-auth grade for each.","tags":["dns","domain","rdap","email","spf"],"parameters":[{"name":"domains","in":"query","required":false,"schema":{"type":"string"},"example":"github.com,example.com"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"count":{"type":"number"},"results":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string"},"registration":{"type":"object","properties":{"age_days":{"type":"number"}}},"email_auth":{"type":"object","properties":{"grade":{"type":"string"}}}}}}}},"example":{"ok":true,"count":2,"results":[{"domain":"github.com","registration":{"age_days":6100},"email_auth":{"grade":"A"}}]}}}}}}}}}