# Preview addresses eligible for batch approval

> GET /addresses/approval-preview

Source: https://docs.trykintsugi.com/reference/2026-07-21/preview-addresses-eligible-for-batch-approval

GET /addresses/approval-preview

Preview addresses eligible for batch approval

Preview the addresses a batch approval would cover across every organization your credential owns; send an `Organization-Id`, `Connection-Id` or `Entity-Id` selector to narrow to one. `status` (comma-separated, default `INVALID,BLANK`) chooses which statuses are eligible, and `limit` caps the returned `addresses` page; `totalEligible` is the full count regardless of `limit`. The same `country`, `has*` and `addressNotEmpty` filters as the summary apply.

Category: Addresses

Query parameters:
status (string) - Comma-separated address statuses to treat as eligible; defaults to `INVALID,BLANK`.
limit (integer) - Maximum number of addresses to return in the preview page.
country (string) - ISO-3166 alpha-2 country code to filter by.
hasCountry (boolean) - Filter to addresses that do (`true`) or do not (`false`) have a country.
hasState (boolean) - Filter to addresses that do (`true`) or do not (`false`) have a state.
hasCity (boolean) - Filter to addresses that do (`true`) or do not (`false`) have a city.
hasCounty (boolean) - Filter to addresses that do (`true`) or do not (`false`) have a county.
hasPostalCode (boolean) - Filter to addresses that do (`true`) or do not (`false`) have a postal code.
addressNotEmpty (boolean) - `true` keeps only addresses with at least one of state, city, postal code or county; `false` keeps only fully empty ones.

Response fields:
totalEligible (integer, required) - Total addresses eligible for approval under the requested filters.
addresses (TransactionAddress[], required) - First page of eligible addresses, capped by `limit`. `totalEligible` is the full count regardless of this cap.
  id (string, required) - Identifier for the address.
  type (PublicAddressTypeEnum, required) - Which party or location this address represents. Tax jurisdiction usually follows `SHIP_TO` (or `BILL_TO` when there is no ship-to).
    allowed values: BILL_TO, SHIP_TO, SHIP_FROM, BILL_FROM
  street1 (string) - First line of the street address. An empty string when none was supplied.
  street2 (string) - Second line of the street address. An empty string when none was supplied.
  city (string) - City or locality. An empty string when none was supplied.
  county (string) - County or district. An empty string when none was supplied.
[truncated, see the reference page]

---

Index of every page: https://docs.trykintsugi.com/llms.txt