KintsugiKintsugi
API reference / Re-queue invalid-address transactions for validation

Re-queue invalid-address transactions for validation

PUT/addresses/revalidation

Re-queue the invalid-address transactions matching the given filters (the same country/countryIn, has*, addressNotEmpty and searchQuery filters as the review list) in one organization for address validation, returning how many were re-queued. Owner/Admin only: 403 if your credential may read the organization but is not permitted, and 404 if you do not own it.

Authorization

Api-KeystringRequired

Your secret API key. Include it with every request.

Headers

Api-Versiondate

Release date, as YYYY-MM-DD. Defaults to 2026-07-21.

Organization-Idstring

Target organization id (Organization-Id selector).

Connection-Idstring

Target connection id; resolves to its organization.

Entity-Idstring

Platform entity id; resolves to a connection's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Query

Every query parameter below is optional. Combine as many as you need and append them to the endpoint as a query string. The example shows a few to get you started.

/addresses/revalidation?searchQuery=<searchQuery>&hasCountry=<hasCountry>&countryIn=<countryIn>
searchQuerystring

Free-text search over the invalid-address transactions to re-queue.

countryInstring

Comma-separated ISO-3166 alpha-2 country codes to filter by; the EU placeholder expands to the EU member states. Overrides country.

countrystring

ISO-3166 alpha-2 country code to filter by.

hasCountryboolean

Filter to addresses that do (true) or do not (false) have a country.

hasStateboolean

Filter to addresses that do (true) or do not (false) have a state.

hasCityboolean

Filter to addresses that do (true) or do not (false) have a city.

hasCountyboolean

Filter to addresses that do (true) or do not (false) have a county.

hasPostalCodeboolean

Filter to addresses that do (true) or do not (false) have a postal code.

addressNotEmptyboolean

true keeps only addresses with at least one of state, city, postal code or county; false keeps only fully empty ones.

Response

revalidatedCountintegerRequired

Number of invalid-address transactions re-queued for validation.

200

Successful Response

400

The request was invalid.

401

Authentication failed or was missing.

403

The credential is not permitted for this request.

404

The requested resource was not found.

409

The request conflicts with existing state.

422

The request failed validation.

cURL
PUT /addresses/revalidation?searchQuery={searchQuery}&hasCountry={hasCountry}&countryIn={countryIn}
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
Example request
https://api.trykintsugi.com/addresses/revalidation?searchQuery={searchQuery}&hasCountry={hasCountry}&countryIn={countryIn}
Response
{
"revalidatedCount": 5
}
Re-queue invalid-address transactions for validation (2026-07-21) | Kintsugi API Reference