Verify Address (with customer context)

POST

/api/v1/public/customer/geocode

Geocodes coordinates for a known customer. Creates or updates the customer record, marks status as Verified, and returns street-view images.

Request

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Customer geocoded and record updated.

Body

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/api/v1/public/customer/geocode' \
--header 'Content-Type: application/json' \
--data-raw '{
    "latitude": 6.5244,
    "longitude": 3.3792,
    "formattedAddress": "25 Marina Street, Lagos Island, Lagos, Nigeria",
    "customerId": "CUST-001"
}'

Response Example

{
    "latitude": 6.5244,
    "longitude": 3.3792,
    "formattedAddress": "25 Marina Street, Lagos Island, Lagos, Nigeria",
    "customerId": "CUST-001",
    "fullName": "Chukwuemeka Obiora",
    "addressImages": [
        {
            "heading": 0,
            "imageUrl": "https://maps.googleapis.com/maps/api/streetview?size=640x480&location=..."
        }
    ]
}

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

Verify Address (no customer context)

Submit GeoLocation