Ip Info Post Batch

---
name: ip-info-post-batch
api: IP Geolocation
method: POST
path: /v1/networking/ip/info/batch
base_url: https://requiems.xyz
description: 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.
---

## 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<string> | yes | body | List of IP addresses to look up (1–50 items, each must be a valid IPv4 or IPv6 address). |

## Request Example

```json
{
  "ips": ["8.8.8.8", "1.1.1.1"]
}
```

## Response Example

```json
{
  "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<object> | 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

- `422` **validation_failed** — The ips array is missing, empty, exceeds 50 items, or contains an invalid IP address.
- `400` **bad_request** — The request body is missing or malformed.