--- title: "Parsed WHOIS" method: GET path: "/v1/{query}/whois/parsed/" tags: ["Lookups"] --- # Parsed WHOIS `GET /v1/{query}/whois/parsed/` ## Request - Base URL: `https://api.domaintools.com` - URL: `https://api.domaintools.com/v1/{query}/whois/parsed/` - Auth: one of: - API key in header `X-Api-Key` - HTTP basic - API key in query parameter `signature` - TypeScript: (a function with typed inputs; its response is checked against the schema) Parsed results for WHOIS records for domain names and IP addresses. ## Path parameters - `query` string, required ## 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. - `format` 'html' | 'json' | 'xml': The desired response format. ## Response `200` OK - union - ParsedWhoisDomain: Response for the Parsed WHOIS (Domain) endpoint. - `response` object - `registrant` string: Registrant organization name (if available). - `registration` object, required: Basic registration information. - `created` string, date, required: Date the domain was created. - `expires` string, date, required: Date the domain registration expires. - `updated` string, date, required: Date the domain record was last updated. - `registrar` string, required: Name of the registrar. - `statuses` string[], required: Domain status codes. - `name_servers` string[], required: List of nameserver hostnames for the domain. - `whois` object, required: Raw WHOIS record information. - `date` string, date, required: Date the WHOIS record was retrieved. - `record` string, required: The raw WHOIS record text. - `parsed_whois` object, required: Parsed and normalized WHOIS data. - `domain` string, required: The domain name. - `created_date` string, date-time, required: ISO 8601 timestamp of when the domain was created. - `updated_date` string, date-time, required: ISO 8601 timestamp of when the domain was last updated. - `expired_date` string, date-time, required: ISO 8601 timestamp of when the domain registration expires. - `statuses` string[], required: Domain status codes. - `name_servers` string[], required: List of nameserver hostnames. - `registrar` object, required: Registrar information. - `name` string: Name of the registrar. - `abuse_contact_phone` string: Registrar abuse contact phone number. - `abuse_contact_email` string: Registrar abuse contact email. May be an empty string when the registrar does not publish one. - `iana_id` string: IANA registrar ID. - `url` string, uri: Registrar website URL. - `whois_server` string: Registrar WHOIS server hostname. May be an empty string when the registrar does not publish one. - `contacts` object, required: Domain contact information organized by role. - `registrant` ParsedWhoisContact: Contact information from a WHOIS record. - `name` string: Contact name. - `org` string: Organization name. - `street` string[]: Street address lines. - `city` string: City. - `state` string: State or region. - `postal` string: Postal code. - `country` string: Country code. - `phone` string: Phone number. - `fax` string: Fax number. - `email` string: Email address. May be empty or a privacy-redaction string rather than an address. - `admin` ParsedWhoisContact: Contact information from a WHOIS record. - `name` string: Contact name. - `org` string: Organization name. - `street` string[]: Street address lines. - `city` string: City. - `state` string: State or region. - `postal` string: Postal code. - `country` string: Country code. - `phone` string: Phone number. - `fax` string: Fax number. - `email` string: Email address. May be empty or a privacy-redaction string rather than an address. - `tech` ParsedWhoisContact: Contact information from a WHOIS record. - `name` string: Contact name. - `org` string: Organization name. - `street` string[]: Street address lines. - `city` string: City. - `state` string: State or region. - `postal` string: Postal code. - `country` string: Country code. - `phone` string: Phone number. - `fax` string: Fax number. - `email` string: Email address. May be empty or a privacy-redaction string rather than an address. - `billing` ParsedWhoisContact: Contact information from a WHOIS record. - `name` string: Contact name. - `org` string: Organization name. - `street` string[]: Street address lines. - `city` string: City. - `state` string: State or region. - `postal` string: Postal code. - `country` string: Country code. - `phone` string: Phone number. - `fax` string: Fax number. - `email` string: Email address. May be empty or a privacy-redaction string rather than an address. - `other_properties` object: Additional properties from the WHOIS record that don't fit standard fields. - `record_source` string, required: The domain name that was queried. - ParsedWhoisIp: Response for the Parsed WHOIS (IP) endpoint. - `response` object - `registrant` string: Top-level organization name for the IP range. - `whois` object, required: Raw WHOIS record information. - `date` string, date, required: Date the WHOIS record was retrieved. - `record` string, required: The raw WHOIS record text. - `source` 'ARIN' | 'RIPE' | 'APNIC' | 'LACNIC' | 'AFRINIC', required: The Regional Internet Registry (RIR) source of the WHOIS data. - `parsed_whois` object, required: Parsed and normalized IP WHOIS data. - `networks` ParsedWhoisIpNetwork[], required: IP network blocks and their allocation details. - `id` string: Network identifier/handle. - `range` object: IP address range information. - `from` string: Starting IP address. IPv4 or IPv6 depending on the queried network. - `to` string: Ending IP address. IPv4 or IPv6 depending on the queried network. - `cidr` string[]: CIDR notation for the range. - `count` integer: Number of IP addresses in the range. - `asn` string[]: Autonomous System Numbers. - `name` string: Network name. - `org` string: Organization name and ID. - `parent` string: Parent network name and ID. - `parent_id` string: Parent network ID. - `customer` string: Customer information. - `country` string: Country code. - `phone` string[]: Contact phone numbers. - `descr` string[]: Description or comments. - `contact_keys` object: References to contact IDs by role. - `status` string: Network allocation status. - `remarks` string[]: Additional remarks. - `notify_email` string[]: Notification email addresses. - `mnt_keys` object: Maintainer keys. - `created_date` string, date-time: Date the network was created. - `updated_date` string, date-time: Date the network was last updated. - `changed_by` string[]: Change history. - `source` string: Data source. - `ref` string, uri: Reference URL for this network. - `other` object: Additional properties. - `contacts` ParsedWhoisIpContact[], required: Organizations and persons associated with the networks. - `id` string: Contact identifier/handle. - `type` 'organization' | 'person': Contact type. - `name` string: Contact name. - `address` string[]: Postal address lines. - `country` string: Country code (lowercase). - `phone` string[]: Phone numbers. - `fax` string[]: Fax numbers. - `email` string[]: Email addresses. - `descr` string[]: Description or comments. - `contact_keys` object: References to other contact IDs by role. - `remarks` string[]: Additional remarks. - `notify_email` string[]: Notification email addresses. - `abuse_mailbox` string[]: Abuse reporting email addresses. - `mnt_keys` object: Maintainer keys. - `created_date` string, date-time: Date the contact was created. - `updated_date` string, date-time: Date the contact was last updated. - `changed_by` string[]: Change history. - `source` string: Data source. - `ref` string, uri: Reference URL for this contact. - `other` object: Additional properties. - `routes` object[]: Routing information (typically empty). - `referral_servers` string[]: Referral server information (typically empty). - `other_properties` object[]: Additional properties from the WHOIS record. - `record_source` string, required: An IP address within the matched network block whose WHOIS record was returned. Usually the queried IP, but the API may return a different representative address in the same range. ## 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)