---
title: "Parsed Domain RDAP"
method: GET
path: "/v1/{domain}/rdap/parsed/"
tags: ["Lookups"]
---

# Parsed Domain RDAP

`GET /v1/{domain}/rdap/parsed/`

## Request

- Base URL: `https://api.domaintools.com`
- URL: `https://api.domaintools.com/v1/{domain}/rdap/parsed/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - HTTP basic
  - API key in query parameter `signature`
- TypeScript: <https://skmtc.dev/domaintools/apis/domaintools-lookups-and-monitors-api/docs/v1/:domain/rdap/parsed/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the most recent Domain-RDAP registration record.

Responses are JSON only. This endpoint doesn't support XML or HTML responses or the `format` query parameter. Omit `format` from your requests.

## Path parameters

- `domain` string, required: A base (apex) domain like example.com, excluding subdomains.

## Query parameters

- `app_partner` string: A short identifier, code, or handle.
- `app_name` string: A short identifier, code, or handle.
- `app_version` string: A short identifier, code, or handle.

## Response `200`

Successful response in JSON format.

- ParsedDomainRdapResponse: Response for the Parsed Domain RDAP endpoint.
  - `response` object
    - `domain_rdap` object[], required: Raw RDAP records from registry and/or registrar sources.
      - `source` 'registry' | 'registrar', required: The source of the RDAP record.
      - `timestamp` string, date-time, required: ISO 8601 timestamp when the RDAP record was retrieved.
      - `link` string, uri, required: URL of the RDAP server that provided the record.
      - `record` string, required: The raw RDAP record as a JSON string.
    - `parsed_domain_rdap` object, required: Parsed and normalized RDAP data.
      - `domain` string, required: The domain name.
      - `handle` string: The registry-assigned unique identifier for this domain.
      - `domain_statuses` string[]: Current status codes for the domain.
      - `creation_date` string, date-time: ISO 8601 timestamp of when the domain was registered.
      - `last_changed_date` string, date-time: ISO 8601 timestamp of the last modification to the domain record.
      - `expiration_date` string, date-time: ISO 8601 timestamp when the domain registration expires.
      - `registrar` object: Information about the domain registrar.
        - `name` string: Name of the registrar.
        - `iana_id` string: IANA-assigned registrar ID.
        - `contacts` object[]: Registrar contact information.
          - `name` string: Contact name.
          - `org` string: Organization name.
          - `email` string: Contact email address. May be empty or a privacy-redaction string (e.g. "REDACTED FOR PRIVACY" or a registrar request-form URL) rather than an address.
          - `phone` string: Contact phone number.
          - `roles` string[]: The roles this contact performs.
      - `contacts` object[]: Domain contact information from RDAP.
        - `handle` string: Unique identifier for this contact.
        - `name` string: Contact name. May be redacted for privacy.
        - `org` string: Organization name.
        - `email` string: Contact email address. May be redacted or a privacy service URL.
        - `phone` string: Contact phone number.
        - `fax` string: Contact fax number.
        - `street` string: Street address.
        - `city` string: City.
        - `postal` string: Postal code.
        - `region` string: State or region.
        - `country` string: Two-character ISO 3166-1 country code.
        - `roles` string[]: The roles this contact performs for the domain.
      - `dnssec` object: DNSSEC status information.
        - `signed` boolean: Whether DNSSEC is enabled for the domain.
      - `nameservers` string[]: List of nameserver hostnames for the domain.
      - `conformance` string[]: RDAP conformance levels supported.
      - `emails` string[]: All email addresses found in the RDAP record.
      - `email_domains` string[]: Unique email domains extracted from email addresses.
      - `unclassified_emails` string[]: Email addresses that don't fit standard contact categories.
    - `record_source` string, required: The domain name that was queried.

## Other responses

- `400`: 400: Bad Request. The request was invalid. The response will contain details about the error.
- `401`: 401: Unauthorized. API credentials are required and were not provided, or the provided credentials are not valid.
- `403`: 403: Forbidden. The API credentials provided do not have access to the requested resource or endpoint.
- `404`: 404: Not Found. The requested resource does not exist.
- `500`: 500: Internal Server Error. An unexpected error occurred on the server. If the problem persists, contact DomainTools support.
- `503`: 503: Service Unavailable. The service is temporarily unavailable.

---

[API](https://skmtc.dev/domaintools/apis/domaintools-lookups-and-monitors-api.md) - [All operations](https://skmtc.dev/domaintools/apis/domaintools-lookups-and-monitors-api/llms.txt) - [OpenAPI document](https://skmtc.dev/domaintools/apis/domaintools-lookups-and-monitors-api/revisions/832f423a9729?raw)