v1

latestOpenAPI 3.1.02026-07-17417.5 KB

Batch lookup

Look up multiple IPs in a single request. Maximum 100 IPs per request.

post/

Query parameters

fieldsstring

Example:city,asn

Comma-separated list of extra fields to include. Valid values: city, continent, subdivision, postal, location, asn.

Request body

string[] required

Example request

[
  "8.8.8.8",
  "1.1.1.1"
]

Response

Array of lookup results. IPs without a match are omitted.

ipstring required

countrystring nullable required

citystring nullable

continentstring nullable

subdivisionstring nullable

postalstring nullable

Example response

[
  {
    "ip": "8.8.8.8",
    "country": "US",
    "city": "Mountain View",
    "continent": "NA",
    "subdivision": "CA",
    "postal": "94043",
    "location": {
      "latitude": 37.386,
      "longitude": -122.0838,
      "accuracy_radius": 1000,
      "time_zone": "America/Los_Angeles"
    },
    "asn": {
      "number": 15169,
      "organization": "Google LLC"
    }
  }
]