---
title: "A domain's registration from its registry's RDAP server: the api: link of every registration answer"
method: GET
path: "/api/registration"
---

# A domain's registration from its registry's RDAP server: the api: link of every registration answer

`GET /api/registration`

## Request

- Base URL: `https://isitdns.net`
- URL: `https://isitdns.net/api/registration`
- Auth: none declared

Finds the registry's RDAP server from the IANA bootstrap file and reads the domain's object: the statuses with what each means for resolution, the dates, the nameservers the registry holds and whether the delegation is signed. Contacts are not returned. 502 when no object came back. HEAD is not answered.

## Query parameters

- `domain` string, required

## Response `200`

The statuses with what each means for resolution, the dates, the nameservers the registry holds, whether the delegation is signed, and every HTTP read made (reads) with its time and status

- RegistrationSummary: One RDAP lookup. A field no read measured is the string "not measured"
  - `domain` string
  - `server` string
  - `status` object[]
    - `status` string
    - `effect` string
    - `meaning` string
  - `events` object
  - `nameservers` string[], nullable: null when the registry sent no nameservers member
  - `delegationSigned` boolean, nullable
  - `tried` string[]: Names walked past that got HTTP 404
  - `walked` object[]: Every name walked past on the way to the registered domain, with the HTTP status it got (404 or 400)
    - `name` string
    - `status` integer
  - `url` string
  - `httpStatus` union
    - integer
    - string
  - `ms` union
    - integer
    - string
  - `readAt` string, date-time
  - `bootstrap` object
    - `url` string
    - `edgeCacheSec` integer
  - `reads` object[]
    - `url` string
    - `at` string
    - `ms` integer
    - `status` integer, nullable
    - `error` string, nullable

## Other responses

- `502`: No object came back: the lookup's own words (error) and every HTTP read made (reads)

---

[API](https://skmtc.dev/isitdns/apis/is-it-dns-api.md) · [All operations](https://skmtc.dev/isitdns/apis/is-it-dns-api/llms.txt) · [OpenAPI document](https://skmtc.dev/isitdns/apis/is-it-dns-api/revisions/d5257837c67b?raw)