gabrielmoreira Endpoint
POST https://requiems.xyz/v1/networking/ip/info/batch
Batch IP Geolocation
Look up geolocation data for up to 50 IP addresses in a single request. Results are returned in input order. Per-item errors are reported inline.
Parameters
| Name | Type | Required | Location | Description |
|---|---|---|---|---|
ips |
array | yes | body | List of IP addresses to look up (1–50 items, each must be a valid IPv4 or IPv6 address). |
Request Example
{
"ips": ["8.8.8.8", "1.1.1.1"]
}
Response Example
{
"data": {
"results": [
{
"ip": "8.8.8.8",
"result": { "ip": "8.8.8.8", "country": "United States", "country_code": "US", "city": "Mountain View", "isp": "Google Public DNS", "is_vpn": false }
},
{
"ip": "1.1.1.1",
"result": { "ip": "1.1.1.1", "country": "Australia", "country_code": "AU", "city": "Sydney", "isp": "Cloudflare", "is_vpn": false }
}
],
"total": 2
},
"metadata": { "timestamp": "2026-01-01T00:00:00Z" }
}
Response Fields
| Field | Type | Description |
|---|---|---|
results |
array | Per-item results in input order. |
results[].ip |
string | The IP address that was looked up. |
results[].result |
object | Geolocation data (omitted on error). Same fields as the single-item endpoint. |
results[].error |
string | Error message if the lookup failed (omitted on success). |
total |
integer | Total number of items processed. |
Errors
422validation_failed — The ips array is missing, empty, exceeds 50 items, or contains an invalid IP address.400bad_request — The request body is missing or malformed.