Skip to main content

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​

The verdict, standardised address, best location and any issues