Domain Intelligence (RDAP & DNS)

Method	Path	Description	Cost
GET	/dns/{domain}	Domain mail servers (DNS MX)	$0.10 default	View details
GET	/domain/{domain}	Domain registration date (RDAP)	$0.10 default	View details

GET/dns/{domain}

$0.10 default

Description

Domain mail servers (DNS MX)

Documentation

Domain mail servers (DNS MX)

Registration date, registrar and status of a domain from the authoritative registry (RDAP), and whether the domain receives e-mail (DNS MX). Supports .nl, .com, .net, .org, .uk, .fr, .app and .dev; registries of .de, .eu and .be publish no registration date.

Pricing

$0.10 default

Parameters

{
  "properties": {
    "domain": {
      "description": "Registrable domain name in lowercase, e.g. example.nl",
      "maxLength": 253,
      "minLength": 4,
      "pattern": "^([a-z0-9-]{1,63}\\.)+[a-z]{2,63}$",
      "type": "string",
      "x-parameter-location": "path"
    }
  },
  "required": [
    "domain"
  ],
  "type": "object"
}

Request schema

{
  "properties": {},
  "required": [],
  "type": "object"
}

Response schema

{
  "properties": {
    "coverage": {
      "properties": {
        "complete": {
          "type": "boolean"
        },
        "scope": {
          "description": "Scope",
          "type": "string"
        }
      },
      "required": [
        "complete",
        "scope"
      ],
      "type": "object"
    },
    "data": {
      "properties": {
        "accepts_mail": {
          "type": "boolean"
        },
        "dnssec_validated": {
          "type": "boolean"
        },
        "domain": {
          "description": "Domain",
          "type": "string"
        },
        "exists": {
          "type": "boolean"
        },
        "mx": {
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "required": [
        "domain",
        "exists",
        "accepts_mail",
        "mx",
        "dnssec_validated"
      ],
      "type": "object"
    },
    "notice": {
      "description": "Source limitations",
      "type": "string"
    },
    "source_url": {
      "description": "Exact upstream request URL",
      "type": "string"
    }
  },
  "required": [
    "data",
    "notice",
    "coverage",
    "source_url"
  ],
  "type": "object"
}

Example request

{
  "domain": "mollie.com"
}

Example response

{
  "coverage": {
    "complete": true,
    "scope": "MX records for one domain"
  },
  "data": {
    "accepts_mail": true,
    "dnssec_validated": true,
    "domain": "mollie.com",
    "exists": true,
    "mx": [
      "10 aspmx2.googlemail.com.",
      "5 alt2.aspmx.l.google.com.",
      "5 alt1.aspmx.l.google.com.",
      "1 aspmx.l.google.com.",
      "10 aspmx3.googlemail.com."
    ]
  },
  "notice": "Public DNS MX lookup at request time (Google Public DNS). DNS shows mail routing, not ownership.",
  "source_url": "https://dns.google/resolve?name=mollie.com&type=MX"
}

Links

External documentation ↗

GET/domain/{domain}

$0.10 default

Description

Domain registration date (RDAP)

Documentation

Domain registration date (RDAP)

Pricing

$0.10 default

Parameters

{
  "properties": {
    "domain": {
      "description": "Registrable domain name in lowercase, e.g. example.nl",
      "maxLength": 253,
      "minLength": 4,
      "pattern": "^([a-z0-9-]{1,63}\\.)+[a-z]{2,63}$",
      "type": "string",
      "x-parameter-location": "path"
    }
  },
  "required": [
    "domain"
  ],
  "type": "object"
}

Request schema

{
  "properties": {},
  "required": [],
  "type": "object"
}

Response schema

{
  "properties": {
    "coverage": {
      "properties": {
        "complete": {
          "type": "boolean"
        },
        "scope": {
          "description": "Scope",
          "type": "string"
        }
      },
      "required": [
        "complete",
        "scope"
      ],
      "type": "object"
    },
    "data": {
      "properties": {
        "domain": {
          "description": "Domain",
          "type": "string"
        },
        "expires_at": {
          "type": [
            "string",
            "null"
          ]
        },
        "last_changed_at": {
          "type": [
            "string",
            "null"
          ]
        },
        "nameservers": {
          "type": "array"
        },
        "rdap_server": {
          "type": [
            "string",
            "null"
          ]
        },
        "registered_at": {
          "description": "RFC 3339 registration event",
          "type": [
            "string",
            "null"
          ]
        },
        "registrar": {
          "type": [
            "string",
            "null"
          ]
        },
        "statuses": {
          "type": "array"
        }
      },
      "required": [
        "domain",
        "statuses",
        "nameservers"
      ],
      "type": "object"
    },
    "notice": {
      "description": "Source limitations",
      "type": "string"
    },
    "source_url": {
      "description": "Exact upstream request URL",
      "type": "string"
    }
  },
  "required": [
    "data",
    "notice",
    "coverage",
    "source_url"
  ],
  "type": "object"
}

Example request

{
  "domain": "mollie.nl"
}

Example response

{
  "coverage": {
    "complete": true,
    "scope": "Authoritative registry RDAP record for one domain"
  },
  "data": {
    "domain": "mollie.nl",
    "expires_at": null,
    "last_changed_at": "2021-03-22T15:18:26Z",
    "nameservers": [
      "ns-cloud-a4.googledomains.com",
      "ns-cloud-a1.googledomains.com",
      "ns-cloud-a2.googledomains.com",
      "ns-cloud-a3.googledomains.com"
    ],
    "rdap_server": "rdap.sidn.nl",
    "registered_at": "2000-05-23T14:06:31Z",
    "registrar": "team.blue nl B.V.",
    "statuses": [
      "active"
    ]
  },
  "notice": "Registry RDAP data at request time. Registrant identity is usually redacted; a registration date shows when the current registration started, not who controls the domain.",
  "source_url": "https://rdap.sidn.nl/domain/mollie.nl"
}

Links

External documentation ↗