KintsugiKintsugi

Batch-approve addresses

POST/addresses/approve

Mark a set of addresses verified and requeue their transactions for tax recalculation, for one organization your credential owns; send an Organization-Id, Connection-Id or Entity-Id selector to name it. Choose the set with addressIds OR filters, exactly one. status limits which verification statuses are eligible (default INVALID,BLANK) and limit caps how many are approved. An already-verified address is skipped, not re-approved.

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.

Body

addressIdsstring[]

Ids of the addresses to approve. Send this or filters, not both. null when selecting by filters instead.

filtersAddressApproveFilters

Filter selecting the addresses to approve. Send this or addressIds, not both. null when selecting by addressIds instead.

statusApprovableAddressStatus[]

Verification statuses eligible for approval; an address outside this set is skipped. Only INVALID and BLANK may be approved, and both are the default.

Available options:INVALIDBLANK
limitinteger

Maximum number of addresses to approve in this request.

Response

approvedCountintegerRequired

Number of addresses this request marked verified.

skippedCountintegerRequired

Number of selected addresses left unchanged because they were already verified.

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
POST /addresses/approve
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
{
"addressIds": [
"addr_2mNpQr7Ls8f3k"
],
"filters": {
"country": "US",
"hasCountry": false,
"hasState": false,
"hasCity": false,
"hasCounty": false,
"hasPostalCode": false,
"addressNotEmpty": false
},
"status": [
"INVALID"
],
"limit": 500
}
Response
{
"approvedCount": 5,
"skippedCount": 1
}
Batch-approve addresses (2026-07-21) | Kintsugi API Reference