---
title: "IP Address Lookup"
method: GET
path: "/v1/ip-lookup"
tags: ["Lookup API"]
---

# IP Address Lookup

`GET /v1/ip-lookup`

## Request

- Base URL: `https://api.leadboxer.com`
- URL: `https://api.leadboxer.com/v1/ip-lookup`
- Auth: API key in header `x-api-key`

Retrieve detailed information about an IP address, including organization, geolocation, ISP details, and metadata.

Returned Data
When a match is found, the following fields are returned:

Organization fields
- ipDomain
- ipOrganization

Geo location fields
- ipCountryName
- ipCountryCode
- ipRegionName
- ipCity
- ipSubContinent
- ipLatitude
- ipLongitude
- ipTimezone

IP address details
- ipIsp
- ipRange
- ipUsageType

Meta data
- searchIp
- searchResponseTimeMs

## Query parameters

- `ip` string, required
- `datasetId` string

## Response `200`

Successfully retrieved IP information

- IpLookupDetails: Resolved IP metadata returned when an IP address is successfully identified
  - `ipRange` string: CIDR range in which the searched IP address belongs
  - `ipCountryCode` string: ISO 3166-1 alpha-2 country code of the IP address
  - `ipCountryName` string: Full country name where the IP address is registered
  - `ipSubContinent` string: Sub-continent or geographical region of the IP address
  - `ipRegionName` string: Administrative region or state of the IP address
  - `ipCity` string: City associated with the IP address
  - `ipLatitude` string: Latitude coordinate of the IP address location
  - `ipLongitude` string: Longitude coordinate of the IP address location
  - `ipTimezone` string: Timezone corresponding to the IP address location
  - `ipIsp` string: Internet Service Provider associated with the IP address
  - `ipOrganization` string: Registered organization or entity owning the IP address
  - `ipDomain` string: Primary domain name associated with the IP address
  - `ipUsageType` 'COM' | 'RES' | 'MOB' | 'DC' | 'EDU' | 'GOV': Usage classification of the IP address
  - `searchIp` string: IP address that was queried in the lookup request
  - `searchResponseTimeMs` integer: Time taken to resolve the IP lookup, in milliseconds

## Other responses

- `400`: Bad Request: The request is invalid or malformed (missing/incorrect parameters).
- `402`: Payment Required: The client has exceeded credit limits.
- `403`: Forbidden: The authenticated user does not have permission to access this resource.
- `404`: Not Found: The requested resource does not exist.
- `409`: Conflict: The request could not be completed due to a resource state conflict.
- `429`: Too Many Requests: Rate limit exceeded. The client has sent too many requests in a given time period
- `500`: Interval Server Error: An unexpected error occurred on the server.

---

[API](https://skmtc.dev/leadboxer/apis/leadboxer-api.md) · [All operations](https://skmtc.dev/leadboxer/apis/leadboxer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/leadboxer/apis/leadboxer-api/revisions/34249b480395?raw)