Geolocation

Returns com.precisely.geolocation for an IP address

The Geolocation Ip Address end point provides the com.precisely.geolocation details.

get/v1/geolocation/ip-address

Request

  • Base URL: https://api.cloud.precisely.com
  • URL: https://api.cloud.precisely.com/v1/geolocation/ip-address
  • Auth: one of:
    • HTTP bearer
    • API key in header Authorization

Query parameters

ipAddressstring required

The IP address for which the com.precisely.geolocation information is being requested.

Headers

X-Request-Idstring

The X-Request-Id header is optional but incredibly useful for developers. It serves as a unique identifier for requests within our system. When you encounter any problems with your requests, providing us with the X-Request-Id will enable us to pinpoint the specific request in question without the need for extensive manual searching. This means faster and more efficient troubleshooting. The maximum allowed length is 38 characters.

Response

IP address com.precisely.geolocation fetched successfully

Example response

{
  "response": {
    "status": "OK",
    "result": {
      "geometry": {
        "accuracy": {
          "unit": "meters",
          "value": "120"
        },
        "coordinates": [
          -77.49154,
          39.03328
        ]
      },
      "ipInfo": {
        "coordinateFormat": "Decimal",
        "ipAddress": "54.86.242.73",
        "ipType": "Mapped",
        "anonymizerStatus": "active",
        "proxy": {
          "description": "hosting-cloud",
          "lastDetected": "2024-05-06T06:46:27Z",
          "level": "elite",
          "name": "amazonaws.com",
          "provider": "Amazon Technologies Inc.",
          "type": "service"
        },
        "network": {
          "organization": "Amazon Technologies Inc.",
          "organizationData": {
            "home": "false",
            "organizationType": "commercial",
            "naicsCode": "517810",
            "isicCode": "6110"
          },
          "carrier": "Amazon.com",
          "asn": 14618,
          "connectionType": "TX",
          "lineSpeed": "medium",
          "ipRouteType": "international proxy",
          "hostingFacility": "true",
          "domainName": "amazonaws.com"
        },
        "location": {
          "city": {
            "areaCode": "703",
            "name": "Ashburn",
            "confidence": 60,
            "postalCode": "20147",
            "postalCodeConfidence": 35,
            "timeZone": -5
          },
          "consistencyCode": 1,
          "continent": "North America",
          "country": {
            "name": "United States",
            "confidence": 90,
            "code": "US",
            "region": "Mid-Atlantic"
          },
          "dma": 511,
          "msa": 47900,
          "state": {
            "county": "Loudoun",
            "name": "Virginia",
            "confidence": 75,
            "code": "VA"
          }
        }
      }
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.