The DNS Propagation API allows you to monitor and validate the DNS record configuration.
With the DNS Propagation API you can:
- Retrieve the DNS propagation status for domains.
- Monitor DNS record configuration and propagation progress.
- Get detailed information about DNS record misconfigurations.
- Check whether required DNS records are properly set up.
Learn more about domain propagation.
It's important to note the following before starting to code:
- We recommend authenticating calls with an API key for your main account instead of using a key for the relevant child account. This won't affect
the responses to calls, which remain consistent across API keys, provided you have the necessary permissions.
- DNS propagation can take up to 48 hours to complete globally. The API accounts for this by automatically scheduling recurring checks over the propagation period.
- The DNS propagation process starts every time a non-pointing domain's DNS records change, not only when the domain is newly set up. Note that for pointing domains, that manage their zone files outside of Wix, DNS propagation monitoring isn't automatically triggered when external changes are made.
- For managed domains that use Wix nameservers, DNS records are automatically re-resolved every 4 days to ensure ongoing accuracy and detect any changes.
- Domain: Domain name including TLD (top-level domain).
- TLD: Top-level domain. For example, "com", "net", or "org".
- DNS: Domain Name System of the internet.
- DNS propagation: The process of DNS record changes spreading across DNS servers globally.
It begins following any changes to a domain's DNS records and may take up to 48 hours to complete.
- Expected DNS records: The DNS records that should be configured for the domain to work properly with Wix.
- Actual DNS records: The DNS records currently configured for the domain.
- Wix nameservers: DNS servers operated by Wix that can be detected in a domain's NS records.