Infivu API Reference

Integrate lightning-fast edge geofencing into your application. Base URL: https://api.infivu.com

Authentication

Authenticate your API requests by including your secret key in the `Authorization` header. You can manage your API keys inside the Infivu Command Center.

Authorization: Bearer sk_infivu_...

POST /v1/verify

Verifies physical hardware coordinates against Cloudflare edge routing telemetry to detect GPS spoofing, proxies, and routing anomalies.

Request Body

ParameterTypeDescription
hardwareLat Float Latitude reported by the client device.
hardwareLon Float Longitude reported by the client device.
deviceRttMs Integer Round Trip Time latency in milliseconds.

Example Request

curl -X POST https://api.infivu.com/v1/verify \
  -H "Authorization: Bearer sk_infivu_test" \
  -H "Content-Type: application/json" \
  -d '{"hardwareLat": 37.751, "hardwareLon": -97.822, "deviceRttMs": 45}'

Example Response (Flagged)

{
  "valid": false,
  "reason": "gps_ip_mismatch",
  "verification_id": "ver_e120cdc2",
  "metadata": {
    "discrepancy_km": 2156
  }
}