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

DateDeveloperTypeDescription
2017-04-19axeladdOnly isp list
2017-11-10axelfixFix isp list
2019-06-18axeladdAdd domain availability checker
2019-11-16axeladdAdd lookup path for domain, entity and nameserver.
2020-05-22axelfixTypo in fieldname in nameserver entity.

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",
					"ldhName": "ns1.isnic.is"
				},
				{
					"objectClassName": "nameserver",
					"ldhName": "ns2.isnic.is"},
				{
					"objectClassName": "nameserver",
					"ldhName": "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"
  ]
}