Submit GeoLocation

POST

/api/v1/public/geolocation

Records a customer's current GPS coordinates with a proximity score (0-100) against stored home coordinates. Deducts GeoLocateCostPerCall from wallet.

Request

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Geolocation recorded.

Body

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/v1/public/geolocation' \
--header 'Content-Type: application/json' \
--data-raw '{
    "latitude": 6.5244,
    "longitude": 3.3792,
    "customerId": "CUST-001"
}'

Response Example

{
    "id": 42,
    "latitude": 6.5244,
    "longitude": 3.3792,
    "formattedAddress": "25 Marina Street, Lagos Island, Lagos, Nigeria",
    "customerId": "CUST-001",
    "fullName": "Chukwuemeka Obiora",
    "customerPhone": "+2348012345678",
    "timestamp": "2026-04-23T10:00:00Z",
    "proximityScore": 87.5,
    "companyId": "8bb73d03-06b4-47c7-80c7-59301f770eda",
    "createdAt": "2019-08-24T14:15:22.123Z"
}

Modified at 2026-04-23 19:30:16

Verify Address (with customer context)

Verify BVN