Get results (processed terms)

POST https://ip-geolocation.whoisxmlapi.com/api/bgservice/request/completed

CURL request sample

curl https://ip-geolocation.whoisxmlapi.com/api/bgservice/request/completed -X POST -H "Content-Type: application/json"  -d '{"apiKey": "YOUR_API_KEY", "id": 622, "format": "json"}'

POST request body sample

{
    "apiKey": "YOUR_API_KEY",
    "id": 596,
    "format": "csv"
}

Input parameters

apiKey

Required. Get your personal API KEY on the My products page.

id

Required. Integer.

ID of the request.

format

Optional. String.

Used to specify the response format.

Allowed values: "xml", "json", "csv".

Default value: "json".

Sample output

{
  "response": [
    [
      {
        "ip": "8.8.8.8",
        "location": {
          "country": "US",
          "region": "California",
          "city": "Mountain View",
          "lat": 37.40599,
          "lng": -122.078514,
          "postalCode": "94043",
          "timezone": "-07:00"
        },
        "domains": [
          "0.cnxelg.top",
          "000180.top",
          "0002.by",
          "00049ok.com",
          "001998.com.he2.aqb.so"
        ],
        "as": {
          "asn": 15169,
          "name": "Google LLC",
          "route": "8.8.8.0/24",
          "domain": "https://about.google/intl/en/",
          "type": "Content"
        },
        "isp": "Google",
        "term": "8.8.8.8"
      }
    ],
    [
      {
        "ip": "2607:f8b0:4007:804::2005",
        "location": {
          "country": "US",
          "region": "California",
          "city": "Mountain View",
          "lat": 37.38605,
          "lng": -122.08385,
          "postalCode": "94041",
          "timezone": "-07:00"
        },
        "isp": "Google",
        "term": "gmail.com"
      },
      {
        "ip": "172.217.11.165",
        "location": {
          "country": "US",
          "region": "California",
          "city": "Mountain View",
          "lat": 37.40599,
          "lng": -122.078514,
          "postalCode": "94043",
          "timezone": "-07:00"
        },
        "domains": [
          "lax28s15-in-f5.1e100.net"
        ],
        "as": {
          "asn": 15169,
          "name": "Google LLC",
          "route": "172.217.0.0/16",
          "domain": "https://about.google/intl/en/",
          "type": "Content"
        },
        "isp": "Google",
        "term": "gmail.com"
      }
    ]
  ]
}

Code: 200 OK.
{
    "response": {
        "error": "Wrong request id"
    }
}

Code: 422 Unprocessable Entity.
response

The response object.

Contains an array of geolocations for each IP address in the original request. See the documentation to get more info.

Responses to these request can be saved directly to disk.

In case of an error it contains its description in the 'error' field. If there are multiple errors their descriptions are returned in the 'errors' array.