LocationResponse

successboolean

Example: true

data object

gps_namestring

Canonical GhanaPostGPS name

Example: AKW4849321

addressstring

Address identifier

Example: AKW4849321

regionstring

Region name

Example: Ashanti

districtstring

District name

Example: Kwadaso

areastring

Area/neighborhood name

Example: Hemang

postcodestring

Postal code

Example: AKW484

streetstring

Street name (if known)

center_latitudenumber<double>

Center latitude of the address area

Example: 6.650080145273592

center_longitudenumber<double>

Center longitude of the address area

Example: -1.648700346667856

north_latitudenumber<double>

North boundary latitude

south_latitudenumber<double>

South boundary latitude

east_longitudenumber<double>

East boundary longitude

west_longitudenumber<double>

West boundary longitude

google_maps_urlstring

Direct link to view the location on Google Maps

Example: https://www.google.com/maps/search/?api=1&query=6.650080,-1.648700

quality_scorenumber<double>

Address confidence score (0.0–1.0) based on data completeness. Useful for KYC and address verification.

Scoring breakdown:

• GPS name (0.15), Region (0.10), District (0.10), Postcode (0.10), Coordinates (0.15) = 0.60 base
• Area (0.10), Street (0.10), Bounding box (0.10), Maps URL (0.10) = 0.40 enrichment

A fully mapped address scores 1.0. Use a threshold (e.g. 0.7) to filter verified addresses.

Possible values: >= 0 and <= 1

Example: 0.85

meta object

request_idstring<uuid>

Unique request identifier

Example: c86825f0-d8ca-4ae1-8226-514cc48e05c0

cachedboolean

Whether the response was served from cache

Example: false

latencystring

Server-side processing time

Example: 1.802457582s

LocationResponse

{
  "success": true,
  "data": {
    "gps_name": "AKW4849321",
    "address": "AKW4849321",
    "region": "Ashanti",
    "district": "Kwadaso",
    "area": "Hemang",
    "postcode": "AKW484",
    "street": "string",
    "center_latitude": 6.650080145273592,
    "center_longitude": -1.648700346667856,
    "north_latitude": 0,
    "south_latitude": 0,
    "east_longitude": 0,
    "west_longitude": 0,
    "google_maps_url": "https://www.google.com/maps/search/?api=1&query=6.650080,-1.648700",
    "quality_score": 0.85
  },
  "meta": {
    "request_id": "c86825f0-d8ca-4ae1-8226-514cc48e05c0",
    "cached": false,
    "latency": "1.802457582s"
  }
}