SearchCtrl+K

APIs/WHOIS APIs/IP WHOIS Lookup API/Reference

WHOIS IP Lookup API Reference

Query real-time WHOIS records for any IPv4 or IPv6 address. Returns organization, CIDR range, network handle, and abuse contacts - sourced live from all 5 RIRs.

GEThttps://api.apifreaks.com/v1.0/ip/whois/live

Test

The WHOIS IP Lookup API provides full network registration data including inet_num blocks, organization details, technical and abuse contacts, routing information, and raw WHOIS text. Perfect for abuse reporting, fraud detection, and network intelligence.

Getting Started

Authentication

Authorize every request with your API key, passed either as a header or as a query parameter:

Header - X-apiKey
Query parameter - apiKey

API Version

This is version v1.0 of the API.

LANGUAGE

curl -X 'GET' \
  'https://api.apifreaks.com/v1.0/ip/whois/live?ip=8.8.8.8' \
  -H 'X-apiKey: API-KEY'

Response

{
  "status": true,
  "ip_address": "8.8.8.8",
  "query_time": "2026-06-05 15: 33: 44",
  "whois_server": "whois.arin.net",
  "inet_nums": [
    {
      "start_ip": "8.8.8.0",
      "end_ip": "8.8.8.255",
      "cidr": [
        "8.8.8.0/24"
      ],
      "net_name": "GOGL",
      "net_handle": "NET-8-8-8-0-2",
      "status": "Direct Allocation",
      "organization": "Google LLC (GOGL)",
      "date_created": "2023-12-28",
      "date_updated": "2023-12-28",
      "source": "https://rdap.arin.net/registry/ip/8.8.8.0",
      "parents": [
        "NET8 (NET-8-0-0-0-0)"
      ]
    }
  ],
  "organization": {
    "handle": "GOGL",
    "name": "Google LLC",
    "address": [
      "1600 Amphitheatre Parkway",
      "Mountain View",
      "CA",
      "94043",
      "US"
    ],
    "street": "Amphitheatre Parkway",
    "city": "Mountain View",
    "state": "CA",
    "zip_code": "94043",
    "country": [
      "US"
    ],
    "date_created": "2000-03-30",
    "date_updated": "2019-10-31",
    "source": "https://rdap.arin.net/registry/entity/GOGL"
  },
  "technical_contacts": [
    {
      "handle": "ZG39-ARIN",
      "name": "Google LLC",
      "email": [
        "arin-contact@google.com"
      ],
      "phone": [
        "+1-650-253-0000"
      ],
      "source": "https://rdap.arin.net/registry/entity/ZG39-ARIN"
    }
  ],
  "abuse_contacts": [
    {
      "handle": "ABUSE5250-ARIN",
      "name": "Abuse",
      "email": [
        "network-abuse@google.com"
      ],
      "phone": [
        "+1-650-253-0000"
      ],
      "source": "https://rdap.arin.net/registry/entity/ABUSE5250-ARIN"
    }
  ],
  "routes": [
    {
      "source": "https://rdap.arin.net/registry/ip/8.8.8.0"
    }
  ],
  "whois_raw_response": "..."
}

API Request

Query Parameters

The following parameters can be used in your API requests. All parameters are passed as query string parameters.

formatoptionalStringdefault: json

Response format: 'json' (default) or 'xml'.

iprequiredString

IPv4 or IPv6 whose WHOIS required

API Response Schema

A successful request returns a 200 OK response with a JSON object containing the WHOIS data. The response includes the top-level fields listed below. See the response preview on the right for the full JSON structure.

status

Booleanmandatory

Indicates if the WHOIS response from whois_server is a complete response

ip_address

Stringmandatory

IP address (IPv4 or IPv6) to query live WHOIS

query_time

Stringmandatory

Date and time of WHOIS query in the yyyy-MM-dd HH:mm:ss format

whois_server

Stringmandatory

WHOIS host server used to query the ip_address

whois_raw_response

Stringmandatory

WHOIS response (unparsed) from the whois_server WHOIS server

r_whois_raw_response

Stringoptional

WHOIS response from the rwhois server

start_ip (String), end_ip (String), cidr (Array<String>), net_name (String), net_handle (String), …

handle (String), address (Array<String>), street (String), city (String), district (String), …

handle (String), name (String), type (String), description (Array<String>), address (Array<String>), …

handle (String), name (String), address (Array<String>), street (String), city (String), …

route (String), origin (String), description (Array<String>), country (String), pingable (Array<String>), …

Custom Response Headers

Besides the response body, every response carries custom headers you can use to track credit usage, and concurrency usage on endpoints that enforce a concurrency limit. See the Custom Response Headers documentation and the endpoints with concurrency limits for more details.

X-Concurrent-Threadsheaderconcurrency-limited endpoints

Specifies the maximum number of concurrent requests allowed.

X-Concurrent-Threads-Activeheaderconcurrency-limited endpoints

Indicates the number of active concurrent requests being processed.

X-AF-Credits-Costheaderall responses

Specifies the number of credits consumed by the current request.

Error Status & Codes

See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.

400

Request-param 'ip' (<ip>) is not valid.

400

Request-param 'format' (<format>) is not valid. Supported formats are json, xml

WHOIS IP Lookup API Reference

Query real-time WHOIS records for any IPv4 or IPv6 address. Returns organization, CIDR range, network handle, and abuse contacts - sourced live from all 5 RIRs.

GEThttps://api.apifreaks.com/v1.0/ip/whois/live

Test

Getting Started

Authentication

Authorize every request with your API key, passed either as a header or as a query parameter:

Header - X-apiKey
Query parameter - apiKey

API Version

This is version v1.0 of the API.

LANGUAGE

curl -X 'GET' \
  'https://api.apifreaks.com/v1.0/ip/whois/live?ip=8.8.8.8' \
  -H 'X-apiKey: API-KEY'

Response

{
  "status": true,
  "ip_address": "8.8.8.8",
  "query_time": "2026-06-05 15: 33: 44",
  "whois_server": "whois.arin.net",
  "inet_nums": [
    {
      "start_ip": "8.8.8.0",
      "end_ip": "8.8.8.255",
      "cidr": [
        "8.8.8.0/24"
      ],
      "net_name": "GOGL",
      "net_handle": "NET-8-8-8-0-2",
      "status": "Direct Allocation",
      "organization": "Google LLC (GOGL)",
      "date_created": "2023-12-28",
      "date_updated": "2023-12-28",
      "source": "https://rdap.arin.net/registry/ip/8.8.8.0",
      "parents": [
        "NET8 (NET-8-0-0-0-0)"
      ]
    }
  ],
  "organization": {
    "handle": "GOGL",
    "name": "Google LLC",
    "address": [
      "1600 Amphitheatre Parkway",
      "Mountain View",
      "CA",
      "94043",
      "US"
    ],
    "street": "Amphitheatre Parkway",
    "city": "Mountain View",
    "state": "CA",
    "zip_code": "94043",
    "country": [
      "US"
    ],
    "date_created": "2000-03-30",
    "date_updated": "2019-10-31",
    "source": "https://rdap.arin.net/registry/entity/GOGL"
  },
  "technical_contacts": [
    {
      "handle": "ZG39-ARIN",
      "name": "Google LLC",
      "email": [
        "arin-contact@google.com"
      ],
      "phone": [
        "+1-650-253-0000"
      ],
      "source": "https://rdap.arin.net/registry/entity/ZG39-ARIN"
    }
  ],
  "abuse_contacts": [
    {
      "handle": "ABUSE5250-ARIN",
      "name": "Abuse",
      "email": [
        "network-abuse@google.com"
      ],
      "phone": [
        "+1-650-253-0000"
      ],
      "source": "https://rdap.arin.net/registry/entity/ABUSE5250-ARIN"
    }
  ],
  "routes": [
    {
      "source": "https://rdap.arin.net/registry/ip/8.8.8.0"
    }
  ],
  "whois_raw_response": "..."
}

API Request

Query Parameters

The following parameters can be used in your API requests. All parameters are passed as query string parameters.

formatoptionalStringdefault: json

Response format: 'json' (default) or 'xml'.

iprequiredString

IPv4 or IPv6 whose WHOIS required

API Response Schema

status

Booleanmandatory

Indicates if the WHOIS response from whois_server is a complete response

ip_address

Stringmandatory

IP address (IPv4 or IPv6) to query live WHOIS

query_time

Stringmandatory

Date and time of WHOIS query in the yyyy-MM-dd HH:mm:ss format

whois_server

Stringmandatory

WHOIS host server used to query the ip_address

whois_raw_response

Stringmandatory

WHOIS response (unparsed) from the whois_server WHOIS server

r_whois_raw_response

Stringoptional

WHOIS response from the rwhois server

start_ip (String), end_ip (String), cidr (Array<String>), net_name (String), net_handle (String), …

handle (String), address (Array<String>), street (String), city (String), district (String), …

handle (String), name (String), type (String), description (Array<String>), address (Array<String>), …

handle (String), name (String), address (Array<String>), street (String), city (String), …

route (String), origin (String), description (Array<String>), country (String), pingable (Array<String>), …

Custom Response Headers

X-Concurrent-Threadsheaderconcurrency-limited endpoints

Specifies the maximum number of concurrent requests allowed.

X-Concurrent-Threads-Activeheaderconcurrency-limited endpoints

Indicates the number of active concurrent requests being processed.

X-AF-Credits-Costheaderall responses

Specifies the number of credits consumed by the current request.

Error Status & Codes

See the HTTP Status Codes documentation for a complete reference of common API errors and HTTP status codes.

400

Request-param 'ip' (<ip>) is not valid.

400

Request-param 'format' (<format>) is not valid. Supported formats are json, xml

Quick Links

Quick Links

WHOIS IP Lookup API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Custom Response Headers

Error Status & Codes

Quick Links

Quick Links

WHOIS IP Lookup API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Custom Response Headers

Error Status & Codes

WHOIS IP Lookup API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Custom Response Headers

Error Status & Codes

More APIs in This Category

Domain WHOIS Lookup API

ASN Lookup API

WHOIS History API

Reverse WHOIS API

Bulk WHOIS Lookup API

WHOIS IP Lookup API Reference

Getting Started

Authentication

API Version

API Request

Query Parameters

API Response Schema

Custom Response Headers

Error Status & Codes

More APIs in This Category

Domain WHOIS Lookup API

ASN Lookup API

WHOIS History API

Reverse WHOIS API

Bulk WHOIS Lookup API