---
title: "Reverse IP WHOIS"
method: GET
path: "/v1/reverse-ip-whois/"
tags: ["Lookups"]
---

# Reverse IP WHOIS

`GET /v1/reverse-ip-whois/`

## Request

- Base URL: `https://api.domaintools.com`
- URL: `https://api.domaintools.com/v1/reverse-ip-whois/`
- 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/reverse-ip-whois/get.ts> (a function with typed inputs; its response is checked against the schema)

Provides a list of IP network ranges with WHOIS records that match a specific query.
NOTE: Either an `ip` or `query` parameter is required.

## Query parameters

- `ip` string, ipv4: A standard IPv4 address.
- `query` string
- `country` string
- `server` 'whois.arin.net' | 'whois.apnic.net' | 'whois.ripe.net' | 'whois.lacnic.net' | 'whois.afrinic.net'
- `include_total_count` boolean: An optional boolean flag that enables a specific feature or response extension when set to `true`. If `false` or omitted, the feature is ignored.
- `page` integer
- `ip_version` 4 | 6
- `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
  - ReverseIpWhoisIp: Response for the Reverse IP WHOIS (IP) endpoint.
    - `response` object
      - `ip_from` string, ipv4
      - `ip_to` string, ipv4
      - `ip_from_alloc` string, ipv4
      - `ip_to_alloc` string, ipv4
      - `record_ip` string, ipv4
      - `record_date` string, date
      - `server` string, hostname
      - `organization` string
      - `country` string
      - `range` string
      - `whois_record` string
  - ReverseIpWhoisQuery: Response for the Reverse IP WHOIS (Query) endpoint.
    - `response` object
      - `has_more_pages` boolean
      - `page` integer
      - `total_count` integer
      - `record_count` integer
      - `records` object[]
        - `ip_from` string, ipv4
        - `ip_to` string, ipv4
        - `record_ip` string, ipv4
        - `record_date` string, date
        - `server` string, hostname
        - `organization` string
        - `country` string
        - `range` string

## 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.
- `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)