Check whether an address can be delivered to
POST/v2/address/validate
Takes an address the way a customer gives it (free text, a GhanaPostGPS code, a Plus Code, a map pin, or any mix) and says whether it can be located for delivery.
It parses the text, finds a location from each input, and checks the
inputs against each other: a GPS code and a pin more than 250 m apart,
a landmark described as "adjacent" that is over 1 km away, or an area
name that does not match the registry's names for that spot. Each
address component is marked confirmed, unconfirmed or inferred,
and the verdict gives possible_next_action:
accept: located to the premise with nothing contradicting it.confirm: usable, but ask the customer to confirm (landmark-level only, or a part that does not match).fix: cannot be located, or the inputs contradict each other.
This checks deliverability. It is not identity or address-ownership verification. When a pin or Plus Code is sent without a GPS code, the location is looked up in the GhanaPostGPS registry to fill in the address parts.
Request
Responses
- 200
- 400
The verdict, standardised address, best location and any issues
Invalid body, unknown field, or no usable input (INVALID_BODY, VALIDATION_ERROR)