List Dynamic DNS credentials

GET

/domains/{domain}/dns/dynamic

List the Dynamic DNS credentials of a domain. A credential lets a router, NAS or script keep the A and/or AAAA record of one hostname up to date with the dyndns2 protocol (https://mijn.host/nic/update). Passwords are never shown here; see create and reset password.

Request

Authorization

Add parameter in header

API-Key

Example:

API-Key: ********************

Path Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://mijn.host/api/v2/domains/domain.com/dns/dynamic' \
--header 'Accept: application/json' \
--header 'User-Agent: my-application/1.0.0' \
--header 'API-Key: <api-key>' \
--header 'Content-Type: application/json'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "status": 200,
    "status_description": "Request successful",
    "data": {
        "domain": "domain.com",
        "credentials": [
            {
                "id": 12,
                "label": "Router at home",
                "hostname": "home",
                "fqdn": "home.domain.com",
                "username": "ddns_a1b2c3d4e5f6",
                "allow_ipv4": true,
                "allow_ipv6": true,
                "force_wildcard": false,
                "active": true,
                "last_ipv4": "203.0.113.7",
                "last_ipv6": null,
                "last_update_at": "2026-11-10T09:43:00+01:00",
                "last_status": "good",
                "created_at": "2026-11-01T12:00:00+01:00",
                "update_url": "https://ddns_a1b2c3d4e5f6:PASSWORD@mijn.host/nic/update?hostname=home.domain.com&myip=&myipv6="
            }
        ]
    }
}

🟠400Invalid input

🟠400SSL connection is required

🟠400No domain set

🟠400You have no access to this resource.

🟠401No valid API key set

🟠401API key has expired

🟠401Remote IP address is not found in the API key whitelist

🔴500Error

Modified at 2026-11-13 09:40:27

Import DNS zonefile

Create Dynamic DNS credential