ISNIC RDAP Interface Specification

Table of Contents

ISNIC RDAP Interface Specification

Introduction

ISNIC has partially implemented RDAP and some non standard RDAP like queries.

Production environment

The RDAP server is running at rdap.isnic.is port 443.

Development environment

None. As of yet

Document history

DeveloperTypeDescription
axeladdOnly isp list
axelfixFix isp list
axeladdAdd domain availability checker
axeladdAdd lookup path for domain, entity and nameserver.

Standard

Lookups

Domain lookup

curl https://rdap.isnic.is/rdap/domain/dæmi.is

Entity lookup

curl https://rdap.isnic.is/rdap/entity/ISHM-IS

Nameserver lookup

curl https://rdap.isnic.is/rdap/nameserver/aker.isnic.is

Non standard

ISNIC has implemented a lookup that is not in the RFC7483 but returns non standard lists of domains.

Lists

Isp list

Removed 2019-11-15 use Isp stat instead.

You can test this by accessing https://rdap.isnic.is/rdap/lists/isp.

Isp stat list

ISNIC did for many years before 1. okt. 2018 send a monthly email to registered DNS service providers. This email contained a list of domains delegated by ISNIC to any of the DNSP's registered nameservers, including additional information on the domain status and the registrants and billing contacts 'kennitala'.

Note this function does not return 'kennitala'.

You can test this by accessing https://rdap.isnic.is/rdap/lists/ispstat.

curl --basic -u YOURHANDLE-IS https://rdap.isnic.is/rdap/lists/ispstat
{
	"rdapConformance": [
		"rdap_level_0"
	],
	"domainSearchResults": [
		{
			"objectClassName": "domain",
			"handle": "5125D-IS",
			"ldhName": "isnic.is",
			"unicodeName": "isnic.is",
			"status": [
				"active"
			],
			"nameservers": [
				{
					"objectClassName": "nameserver",
					"ldnName": "ns1.isnic.is"
				},
				{
					"objectClassName": "nameserver",
					"ldnName": "ns2.isnic.is"},
				{
					"objectClassName": "nameserver",
					"ldnName": "ns3.isnic.is"
				}
			],
			"entities": [
				{
					"objectClassName": "entity",
					"handle": "ISHM-IS",
					"roles": [
						"registrant",
						"billing"
					]
				}
			]
		}
	]
}

Domain availabilty check

To check if a domain is available use https://rdap.isnic.is/rdap/dac/<DOMAIN TO CHECK>.

Where the <DOMAIN TO CHECK> variable is the domain in ASCII or IDNA.

The http status codes returned can be

curl https://rdap.isnic.is/rdap/dac/ísnic.is
{
  "rdapConformance": [
    "rdap_level_0",
    "isnic_dac_0"
  ],
  "objectClassName": "domain",
  "ldhName":	"xn--snic-upa.is",
  "unicodeName":	"ísnic.is",
  "status": [
    "active"
  ]
}				
curl https://rdap.isnic.is/rdap/dac/isnic_does_not_exist.is
{
  "errorCode": 404,
  "description": [
    "available"
  ]
}