Address - Global

COMING SOON!!!
The Address Verification API is reserved for a future global address validation and enrichment service.

This endpoint will be used for broader international address verification beyond UK postcode-only checks, including structured address validation and normalization for global coverage.

For UK postcode verification, please use the dedicated UK Postcode Verification endpoint.

Endpoint

POST

https://api.provero.io/api/validate/address

Headers

Authorization: Bearer REPLACE_WITH_API_TOKEN
Content-Type: application/json
Accept: application/json

Request Body

Field	Type	Required	Description
`address`	`object`	No	Placeholder request body for the upcoming global address verification API. Final request fields are not yet defined.

Request Body example (JSON)

{
    "address": "London"
}

Code Examples

import requests

url = "https://api.provero.io/api/validate/address"
payload = {
    "address": {
        "line1": "10 Downing Street",
        "city": "London",
        "postcode": "SW1A 2AA",
        "country": "GB"
    }
}

headers = {
    "Authorization": "Bearer REPLACE_WITH_API_TOKEN",
    "Content-Type": "application/json",
    "Accept": "application/json"
}

response = requests.post(url, headers=headers, json=payload)
print(response.status_code)
print(response.text)

<?php
$payload = [
    "address" => [
        "line1" => "10 Downing Street",
        "city" => "London",
        "postcode" => "SW1A 2AA",
        "country" => "GB"
    ]
];

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://api.provero.io/api/validate/address",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => json_encode($payload),
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer REPLACE_WITH_API_TOKEN",
        "Content-Type: application/json",
        "Accept: application/json"
    ]
]);

$response = curl_exec($curl);
if (curl_errno($curl)) {
    echo 'Error:' . curl_error($curl);
}
curl_close($curl);
echo $response;

$response = Http::withToken('REPLACE_WITH_API_TOKEN')
    ->acceptJson()
    ->post('https://api.provero.io/api/validate/address', [
        'address' => [
            'line1' => '10 Downing Street',
            'city' => 'London',
            'postcode' => 'SW1A 2AA',
            'country' => 'GB',
        ],
    ]);

return $response->json();

const payload = {
    address: {
        line1: "10 Downing Street",
        city: "London",
        postcode: "SW1A 2AA",
        country: "GB"
    }
};

fetch("https://api.provero.io/api/validate/address", {
    method: "POST",
    headers: {
        "Authorization": "Bearer REPLACE_WITH_API_TOKEN",
        "Content-Type": "application/json",
        "Accept": "application/json"
    },
    body: JSON.stringify(payload)
})
    .then(response => response.text())
    .then(result => console.log(result))
    .catch(error => console.error("Error:", error));

curl -X POST https://api.provero.io/api/validate/address \
  -H "Authorization: Bearer REPLACE_WITH_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "address": {
      "line1": "10 Downing Street",
      "city": "London",
      "postcode": "SW1A 2AA",
      "country": "GB"
    }
  }'

Response Examples

Application Error - Not Implemented Yet

{
    "message": "Address verification is not available yet. This endpoint is reserved for an upcoming release.",
    "status": "not_implemented"
}

Response Body

Error structure

Field Name	Type	Example	Always Present	Description
`message`	`string`	Address verification is not available yet. This endpoint is reserved for an upcoming release.	Yes	Placeholder message returned until the global address verification service is implemented.
`status`	`string`	not_implemented	Yes	Placeholder status indicating the endpoint is reserved for a future release.