Get results (processed terms) | Documentation | IP Geolocation Bulk API | WhoisXML API

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 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.

Have questions?

We are here to listen. For a quick response, please select your request type or check our Contact us page for more information. By submitting a request, you agree to our Terms of Service and Privacy Policy.

Or shoot us an email to