Provero Logo

IP geolocation API

The IP geolocation API provides insights about the country and city associated with an IP address, along with optional distance comparison to a user-provided address.
This can be used to flag unexpected or foreign leads without affecting lead acceptance decisions.

Endpoint

POST
https://api.provero.io/api/fraud-check/geoip

Headers

Authorization:
Content-Type: application/json
Accept: application/json


Request Body

Field Type Required Description
ip string Yes The IP address to be validated.
address string No Optional address or postcode to calculate distance from IP location. Required if geoMatch is used.
geoMatch boolean No Enable matching between IP’s geolocation and the supplied address.
Request Payload Example (JSON)
{
    "ip": "8.8.8.8",
    "address": "London",
    "geoMatch": true
}

Request Examples

Choose language Bash (cURL) 5 examples
ip="0.0.0.0" # Replace with clients IP
address="REPLACE_WITH_AN_ADDRESS" # Optional address for distance calculation
geoMatch=true # Enable geoMatch to compare IP location with address

curl -X POST https://api.provero.io/api/fraud-check/geoip \
  -H "Authorization: Bearer REPLACE_WITH_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d "{ \"ip\": \"$ip\", \"address\": \"$address\", \"geoMatch\": $geoMatch }"

Response Examples

Choose response example Success 6 examples
{
    "country": "Ireland",
    "regionName": "Leinster",
    "city": "Dublin",
    "zip": "D02",
    "lat": "53.3498",
    "lon": "-6.26031",
    "ip": "46.51.128.144",
    "distance": {
        "km": 0.0514,
        "mi": 0.0319
    },
    "geoMatch": {
        "country": true,
        "city": true
    }
}

Response Body

Success structure

Field Name Type Always
Returned
Example
country string Yes
regionName string Yes
city string Yes
zip string Yes
lat string Yes
lon string Yes
ip string Yes
distance.km string No
distance.mi string No
geoMatch.country boolean No
geoMatch.city boolean No

Error structure

Field Name Type Always
Returned
Example Description
message string No Top-level error message returned on validation failure, insufficient balance, or other request errors.
errors object No Object of validation services with validation failures.
requestError object No Object containing service exceptions for application errors.
service string No Service alias returned with a 402 insufficient-balance response.
required_amount string No Credit amount required to process the validation request.
current_balance string No Current available balance at the time the request was rejected.