1. ProximityScore
FigoVerify Public API
  • VerifyAddress
    • Verify Address (no customer context)
      POST
    • Verify Address (with customer context)
      POST
  • SubmitGeoLocation
    • Submit GeoLocation
      POST
  • VerifyBVN
    • Verify BVN
      POST
  • VerifyNIN
    • Verify NIN
      POST
  • WalletBalance
    • Check Wallet Balance
      GET
  • ProximityScore
    • Get Customer Proximity Score
      GET
  • Schemas
    • GeocodeRequest
    • StreetViewImage
    • GeocodeResponse
    • CustomerGeocodeRequest
    • CustomerGeocodeResponse
    • GeoLocationRequest
    • GeoLocationResponse
    • VerifyBVNRequest
    • VerifyBVNResponse
    • VerifyNINRequest
    • VerifyAddressInfo
    • VerifyNINResponse
    • VerifyValidationField
    • WalletBalanceResponse
    • VerifyValidationResult
    • ProximityScoreResponse
    • VerifyIdData
    • DefaultServiceResponse
    • ErrorResponse
    • ServiceResponse
  1. ProximityScore

Get Customer Proximity Score

GET
/api/v1/public/{customerId}/proximity-score
Returns average proximity score and statistics for a customer across geolocation logs within the date range.

Request

Path Params

Query Params

Responses

🟢200
application/json
Proximity score summary.
Body

🟠401
🟠404
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/api/v1/public//proximity-score?from&to'
Response Response Example
{
    "status": true,
    "message": "Success",
    "data": {
        "customerId": "CUST-001",
        "customerFullName": "Chukwuemeka Obiora",
        "homeAddress": "25 Marina Street, Lagos Island, Lagos, Nigeria",
        "homeLatitude": 6.5244,
        "homeLongitude": 3.3792,
        "totalLogsAnalyzed": 12,
        "averageProximityScore": 78.3,
        "dateRangeFrom": "2026-04-01T00:00:00Z",
        "dateRangeTo": "2026-04-23T23:59:59Z",
        "scoreInterpretation": "Low confidence"
    }
}
Modified at 2026-04-23 19:30:16
Previous
Check Wallet Balance
Next
GeocodeRequest
Built with