How do I update my IP address using the API?

You can trigger an update by making an HTTP request to our update endpoint using your unique API key. The simplest way is via cURL:

curl -fsS \
-H "X-API-Key: YOUR_API_KEY" \
"https://mark-wesley.co.uk/tools/ddns-service/update.php"

Can I pass a custom IP address in the request?

Yes! If you want to push a specific IPv4 address rather than letting the server detect your remote connection IP automatically, you can pass it via a query or POST parameter:

curl -fsS \
-H "X-API-Key: YOUR_API_KEY" \
"https://mark-wesley.co.uk/tools/ddns-service/update.php?ip=192.168.1.100"

What is the rate limit for API check-ins?

To prevent abuse, check-ins that result in an IP change are limited to a maximum of 30 requests per 5-minute window per hostname. Requests where the IP has not changed are logged as unchanged and do not count against this strict limit.

What are the differences between Free and Premium plans?

Free Plan: Includes up to 5 active hostnames, a standard 300-second (5 minute) TTL, default system naming conventions, and requires manual verification every 30 days.
Premium Plan: Includes unlimited hostnames, customizable device names, fast DNS TTLs down to 60 seconds, Discord webhook change alerts, fallback IP protection, the Advanced Diagnostics suite, and hostnames that never expire.

Do Free hostnames expire?

Yes. To keep our network fast and free of abandoned routing configurations, Free tier hostnames expire after 30 days. If they are not renewed, they are permanently deleted and released back into the public pool.

How do I renew my Free hostname?

Our automated system will email you 7 days, 3 days, and 24 hours before your hostname is scheduled for deletion. To keep it active, simply log into your dashboard and click the red Verify & Renew button next to your hostname to instantly reset the 30-day countdown. It takes less than a second!

How do Premium Redeem Codes work?

If you have an activation code, head over to the Redeem Code page. Each code adds 30 days of Premium access to your account. If you are already Premium, redeeming another code will safely stack 30 additional days onto your current expiration date.

What happens if my Premium subscription expires?

Your account will automatically revert to the Free plan (limiting active hostnames to 5). Any hostnames over the 5-limit threshold will be automatically disabled from newest to oldest. Additionally, all your hostnames will be placed on a 30-day expiration timer until you renew your premium status.

What is a Fallback IP?

Premium users can designate a Fallback IPv4 address inside their hostname management settings. If an API update fails or the platform enters a global emergency kill-switch state, our infrastructure will automatically route your traffic to your fallback address to ensure your services remain reachable.

How do Discord Webhooks work?

By pasting your Discord channel webhook URL into your hostname settings, our server will instantly send an alert payload every time your public IP address changes. If you provide your numeric Discord User ID, the alert will also tag you directly in the message!

What is the Diagnostics Tool?

The Diagnostics suite performs a real-time network sweep of your hostname. It queries global DNS resolution times, checks for IP synchronization mismatches, scans common ports (80, 443, 22, 8123), and inspects the validity of your SSL certificates. Some features are only available to Premium users, but the basic checks are free for everyone.

I changed my email address and got locked out?

For security purposes, modifying the email address associated with your account instantly places your account into an unverified state. You will be allowed to finish your current session, but you must click the link sent to your new email address to re-verify your identity before you can log in again.

Can I check my port forwarding for free without upgrading?

Yes! If you only need to check an individual port manually, you can use external web utilities like canyouseeme.org or use native command-line tools (such as nc -zv on Linux/Mac or Test-NetConnection in Windows PowerShell).

Our built-in dashboard port tracker is a Premium convenience feature that automates this workflow, allowing you to batch-scan multiple ports across all your active hostnames simultaneously without leaving your control panel.