Global address validation API

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": {
      "addressLines": ["1600 Pennsylvania Avenue NW", "Washington, DC 20500, USA"]
    },
    "output_format": "standard"
  }'

import requests

response = requests.post(
    "https://api.provero.io/api/validate/address",
    headers={
        "Authorization": "Bearer REPLACE_WITH_API_TOKEN",
        "Content-Type": "application/json",
        "Accept": "application/json",
    },
    json={
        "address": {
            "addressLines": ["1600 Pennsylvania Avenue NW", "Washington, DC 20500, USA"],
        },
        "output_format": "standard",
    },
)

print(response.status_code)
print(response.json())

<?php

$payload = array (
  'address' => 
  array (
    'addressLines' => 
    array (
      0 => '1600 Pennsylvania Avenue NW',
      1 => 'Washington, DC 20500, USA',
    ),
  ),
  'output_format' => 'standard',
);
$curl = curl_init('https://api.provero.io/api/validate/address');
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode($payload),
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer REPLACE_WITH_API_TOKEN',
        'Content-Type: application/json',
        'Accept: application/json',
    ],
]);
echo curl_exec($curl);
curl_close($curl);

$response = Http::withToken('REPLACE_WITH_API_TOKEN')
    ->acceptJson()
    ->post('https://api.provero.io/api/validate/address', [
        'address' => [
            'addressLines' => ['1600 Pennsylvania Avenue NW', 'Washington, DC 20500, USA'],
        ],
        'output_format' => 'standard',
    ]);

return $response->json();

const response = await 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({
        address: {
            addressLines: ["1600 Pennsylvania Avenue NW", "Washington, DC 20500, USA"]
        },
        output_format: "standard"
    })
});

const data = await response.json();

{
    "address": {
        "address_line_1": "1600 Pennsylvania Avenue NW",
        "address_line_2": "",
        "address_line_3": "",
        "locality": "Washington",
        "sublocality": "",
        "administrative_area": "DC",
        "postal_code": "20500",
        "sorting_code": "",
        "country_code": "US",
        "language_code": "",
        "formatted_address": "1600 Pennsylvania Avenue NW, Washington, DC 20500, USA"
    },
    "verdict": "Exact match",
    "qualification": "Address confirmed as entered."
}

{
    "address_line_1": "1600 Pennsylvania Avenue NW",
    "address_line_2": "",
    "address_line_3": "",
    "locality": "Washington",
    "sublocality": "",
    "administrative_area": "DC",
    "postal_code": "20500",
    "sorting_code": "",
    "country_code": "US",
    "language_code": "",
    "formatted_address": "1600 Pennsylvania Avenue NW, Washington, DC 20500, USA",
    "result": {
        "verdict": {
            "inputGranularity": "PREMISE",
            "validationGranularity": "PREMISE",
            "geocodeGranularity": "PREMISE",
            "addressComplete": true,
            "hasUnconfirmedComponents": false,
            "possibleNextAction": "ACCEPT"
        },
        "address": {
            "formattedAddress": "1600 Pennsylvania Avenue NW, Washington, DC 20500, USA",
            "postalAddress": {
                "regionCode": "US",
                "postalCode": "20500",
                "administrativeArea": "DC",
                "locality": "Washington",
                "addressLines": [
                    "1600 Pennsylvania Avenue NW"
                ]
            },
            "addressComponents": [
                {
                    "componentName": {
                        "text": "1600"
                    },
                    "componentType": "street_number",
                    "confirmationLevel": "CONFIRMED"
                }
            ]
        },
        "geocode": {
            "location": {
                "latitude": 38.8977,
                "longitude": -77.0365
            }
        },
        "metadata": {
            "business": false,
            "poBox": false,
            "residential": false
        }
    },
    "responseId": "example-response-id"
}

{
    "message": "The address field is required.",
    "errors": {
        "address": [
            "The address field is required."
        ]
    }
}

{
    "message": "Insufficient balance for validation request.",
    "service": "address",
    "required_amount": "0.0460000000",
    "current_balance": "0.0000000000"
}

{
    "requestError": {
        "serviceException": {
            "messageId": "Address validation request failed.",
            "code": 502
        }
    }
}