Domain Registration-state
Read public RDAP registration state for a domain: registrar or managing entity when published, registration and expiry dates, and registry status codes. This is a registration/ownership-lifecycle lookup only; it does not perform DNS, mail, TLS or website checks.
Forest exposes this capability as a deterministic machine-readable API for software agents. Discovery is free; execution uses the canonical paid endpoint below. The live x402 challenge is the source of truth for payment terms.
$0.002 / callPOST /domain/registration-statex402 · Base
Typical agent tasks
This capability is intended for bounded machine decisions such as:
- look up the registrar and public registration record for a domain
- find domain registration and expiration dates from RDAP
- check registry status and lifecycle state for a domain
- inspect who manages a domain according to public RDAP data
What Forest guarantees
- bounded normalized public-source lookup
Boundaries
- provider-specific guarantees
- unpublished facts
Machine contract
The request and response schemas are published in the canonical OpenAPI document. This page shows a representative input from the same production manifest.
Input example
{
"domain": "example.com"
}
Canonical paid endpoint
https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/domain/registration-state
Related capabilities
- Domain Preflight — Resolve a bare public domain into operational registration, DNS, HTTPS/TLS and mail-policy state using IANA-routed RDAP, DNS, MX/TXT/SPF/DMARC and a bounded TLS probe. No registrant personal data, vulnerability scanning, mailbox existence or deliverability claim. Provider uncertainty is explicit.
- Domain Mail-preflight — MX/SPF/DMARC preflight; not mailbox verification.
- Dns Snapshot — Fetch one bounded public DNS snapshot for A, AAAA, CNAME, MX, NS, SOA and TXT in a single call. Forest uses a fixed public DNS-over-HTTPS resolver, distinguishes answers, NODATA, NXDOMAIN and per-type resolver errors, and marks mixed trustworthy/error outcomes as partial instead of converting resolver failure into an empty DNS result.