Skip to content

List DynDNS update logs

GET /api/v2/domains/{id}/dyndns/{configId}/logs

Lists the latest 50 update attempts for one DynDNS configuration, newest first. Each entry shows the old and new address, where the request came from and whether it worked. Use it when a router or DynDNS client does not change the record as expected. Only updates that match this configuration’s host name and token are logged: a wrong token or host name, or an update refused for too many requests, leaves no entry. Entries older than 30 days are removed.

Authentication: An API key with the scope read:domains. About keys and scopes

Request

Path parameters

idstringrequired
The domain ID (dom_…).
configIdstringrequired
The DynDNS configuration ID (ddns_…) from configs[].id on GET /api/v2/domains/{id}/dyndns.

Example

GET /api/v2/domains/{id}/dyndns/{configId}/logs
curl "https://cloud.hostup.se/api/v2/domains/dom_01hxa3b4c5d6e7f8g9h0j1k2m3/dyndns/ddns_01hxa3b4c5d6e7f8g9h0j1k2m3/logs" \
-H "Authorization: Bearer $HOSTUP_API_KEY"

Responses

200 The latest update attempts.

Response 200
{
"logs": [
{
"oldIp": "198.51.100.40",
"newIp": "198.51.100.45",
"sourceIp": "198.51.100.45",
"userAgent": "ddclient/3.11.2",
"status": "success",
"errorMessage": null,
"createdAt": "2026-04-27T12:00:00.000Z"
}
]
}
Response fields
logsarray of object
Update attempts, newest first.
oldIpstring | null
The address before the update.
newIpstring | null
The address the record was set to. Null when the update failed.
sourceIpstring | null
The address the update request came from.
userAgentstring | null
The User-Agent of the client that sent the update.
statusstring
success (the record changed), no_change (the address was already set), failed or unknown. One of success, no_change, failed, unknown.
errorMessagestring | null
Why the update failed, or a note on a successful update (for example that a missing record was recreated). Null otherwise. IP addresses, URLs and internal host names are masked.
createdAtstring | null
When the update arrived.

Errors

Errors are Problem Details with a stable code. Branch on the code, not on the text.

401Unauthorized. Authentication is required.
403Forbidden. The caller lacks a required scope or does not own the resource.
404The domain or the configuration was not found. code is domain_not_found for the domain, dyndns_config_not_found for an unknown configuration ID, and not_found for a configuration that was deleted or is not on this domain.
429Rate limited. Retry after the limit resets. 429 responses include Retry-After seconds plus X-RateLimit-* headers.
500Internal error. Retry later or contact support if the issue persists.