Validate address (global)

Verifies an address by checking whether we have a matching verified deliverable address.

For high-accuracy results, we suggest including the address, state, and country in the address string, e.g., Landmark Towers, Victoria Island, Lagos, Nigeria.

If address latitude and longitude are provided in the request, it will be used to validate the address, disregarding the address string provided.

POST https://api.shipbubble.com/v1/shipping/address/validate

Request Body

Name	Type	Description
name*	String	name of address holder
email*	String	email address of address holder
phone*	String	phone number of address holder
address*	String	address name to be validated
latitude	Number	address latitude (if available)
longitude	Number	address longitude (if available)

200: OK The address code is used to uniquely identify each verified address entry

{
    "status": "success",
    "message": "Validation successful",
    "data": {
        "name": "Lebron James",
        "email": "[email protected]",
        "phone": "[phone]",
        "formatted_address": "15 Babatunde Jose St, Victoria Island 106104, Lagos, Nigeria",
        "country": "Nigeria",
        "country_code": "NG",
        "city": "Lagos",
        "city_code": "Lagos",
        "state": "Lagos",
        "state_code": "LA",
        "postal_code": "106104",
        "latitude": 6.436058,
        "longitude": 3.433361,
        "address_code": 98794022
    }
}

422: Unprocessable Entity

{
    "status": "failed",
    "message": "Invalid request parameters",
    "errors": [
        "Recipient full name is required",
        "Recipient valid email address is required",
        "Recipient phone number is required",
        "Recipient address is required"
    ]
}