POST /customers/{id}/address:recheck

Coverage-watcher: re-run free L1 for a declared-only postcode (no auth beyond tenant)

Bearer API key or staff session operation recheckCustomerAddress

Parameters

Name	In	Type	Required	Description
`id`	path	string	Yes	—

Request

This endpoint has no request body.

curl -X POST "$MONICHEK_API/customers/{id}/address:recheck" \
  -H "Authorization: Bearer $MONICHEK_API_KEY"

const res = await fetch(`${MONICHEK_API}/customers/{id}/address:recheck`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${MONICHEK_API_KEY}`,
  },
});

const data = await res.json();

import os
import requests

res = requests.post(
    f"{os.environ['MONICHEK_API']}/customers/{id}/address:recheck",
    headers={"Authorization": f"Bearer {os.environ['MONICHEK_API_KEY']}"},
)
print(res.json())

$ch = curl_init(getenv('MONICHEK_API') . '/customers/{id}/address:recheck');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('MONICHEK_API_KEY'),
    ],
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Replace {id} with the resource id.

Responses

200 OK upgraded true appends a new verified entry (history is append-only); otherwise an honest no-op — cron over the back-book as the registry fills application/json

{
  "object": "address_recheck",
  "customer_id": "cus_01M3R...",
  "upgraded": true,
  "state": "verified",
  "postcode": "EK-01-A03-FK-01"
}

Error responses

Status	Meaning	Body
404	Not Found	RFC 9457 problem
502	Bad Gateway	RFC 9457 problem

Errors use the RFC 9457 problem format with a stable code.