One call. An answer you can act on.

curl https://api.rightdoor.eu/v1/validate \
  -H "Authorization: Bearer $RIGHTDOOR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "countryCode": "NL",
    "address1": "binenhof 1a",
    "zip": "2513aa",
    "city": "amsterdam",
    "lang": "en"
  }'
# "status": "corrected"
# "meta": { "source": "Kadaster BAG", … }

const res = await fetch("https://api.rightdoor.eu/v1/validate", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.RIGHTDOOR_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    countryCode: "NL",
    address1: "binenhof 1a",
    zip: "2513aa",
    city: "amsterdam",
    lang: "en",
  }),
  signal: AbortSignal.timeout(5000), // 1.5 s if someone is waiting in a form
});
const result = await res.json();
// result.status: "corrected"
// result.formatted: ["Binnenhof 1 A", "2513 AA 's-Gravenhage"]

<?php
$ch = curl_init('https://api.rightdoor.eu/v1/validate');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT_MS => 5000, // 1500 if someone is waiting in a form
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('RIGHTDOOR_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([
        'countryCode' => 'NL',
        'address1' => 'binenhof 1a',
        'zip' => '2513aa',
        'city' => 'amsterdam',
        'lang' => 'en',
    ]),
]);
$body = curl_exec($ch);
$code = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
// On a timeout, a network error or a 5xx, accept the address as typed (fail open).
$result = ($body === false || $code >= 500) ? null : json_decode($body, true);
// $result['status']: "corrected"

use serde_json::{json, Value};
use std::time::Duration;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let key = std::env::var("RIGHTDOOR_KEY")?;
    let result: Value = reqwest::Client::new()
        .post("https://api.rightdoor.eu/v1/validate")
        .bearer_auth(key)
        .timeout(Duration::from_secs(5))
        .json(&json!({
            "countryCode": "NL",
            "address1": "binenhof 1a",
            "zip": "2513aa",
            "city": "amsterdam",
            "lang": "en"
        }))
        .send()
        .await?
        .json()
        .await?;
    println!("{} {}", result["status"], result["formatted"]); // "corrected" ["Binnenhof 1 A","2513 AA 's-Gravenhage"]
    Ok(())
}