# Summarize addresses by verification status

> GET /addresses/summary

Source: https://docs.trykintsugi.com/reference/2026-07-21/summarize-addresses-by-verification-status

GET /addresses/summary

Summarize addresses by verification status

Count addresses by verification status across every organization your credential owns; send an `Organization-Id`, `Connection-Id` or `Entity-Id` selector to narrow to one. Filter the counted set with `country`, the `has*` presence filters and `addressNotEmpty`, and with `addressType`. `total` is the sum of `byStatus`.

Category: Addresses

Query parameters:
addressType (PublicAddressTypeEnum) - Address role to filter by (e.g. `SHIP_TO`).
  allowed values: BILL_TO, SHIP_TO, SHIP_FROM, BILL_FROM
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:
total (integer, required) - Total addresses in scope, the sum of `byStatus`.
byStatus (AddressStatusCount[], required) - One entry per status present in scope. A status with no addresses is omitted rather than reported as zero.
  status (PublicAddressStatusEnum, required) - The verification status this count is for.
    allowed values: UNVERIFIED, INVALID, PARTIALLY_VERIFIED, VERIFIED, UNVERIFIABLE, BLANK
  count (integer, required) - Number of addresses in scope with this status.

Response statuses: 200, 400, 401, 403, 404, 409, 422

---

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