The Ipregistry API offers 3 different endpoints to use based on your needs:
- Single Lookup
Look up the data behind a single IP address.
- Batch Lookup
Look up the data behind multiple addresses at once.
- Origin Lookup
Look up the data behind an IP address your API request is coming from.
This is the primary Ipregistry endpoint. It is used to look up any given IPv4 or IPv6 addresses. To call this endpoint, simply attach an IP address to the API's base URL:
The batch API endpoint allows you to group up to 256 Ipregistry API requests into a single request. This can really speed up the processing of bulk IP look ups.
We support 2 methods to pass values to a batch request: comma-separated and JSON array.
In order to process IP addresses in bulk with this method, simply append multiple comma-separated IP addresses to the API's base URL:
JSON array as POST body
To make a batch request you can also POST a JSON array containing all IP addresses you'd like to get the data for. Here's an example that uses cURL and the batch endpoint to get information about 3 different IP addresses with a single API call:
curl --data '["188.8.131.52", "184.108.40.206", "220.127.116.11"]' \ --header "Content-Type: application/json" \ --request POST https://api.ipregistry.co/?key=YOU_API_KEY
Responses: for JSON outputs, the response includes a
results field that has for value a JSON Array that contains one IP data object per requested IP address. Similarly, for XML outputs, a main element
This endpoint returns details for the calling address. It allows you to look up your own (or a visitor to your site) IP address details without knowing the IP address in advance:
In addition to IP related data, this endpoint also returns user-agent specific data. This information may be used to filter users based on the application type, operating system, software vendor and revision.
If you are interested by User-Agent data only, we provide a dedicated endpoint at