# Update transaction addresses in a batch

> PUT /addresses/transactions

Source: https://docs.trykintsugi.com/reference/2026-10-06/update-transaction-addresses-in-a-batch

PUT /addresses/transactions

Update transaction addresses in a batch

Update the addresses on a batch of transactions in one organization. Identify each address by `id`, or omit `id` and identify it by `transactionId` + `type` to upsert. Setting an address resets its transaction and re-queues address validation. Returns one `UPDATED`/`FAILED` result per input address, in request order; an upsert's result has a null `addressId`. `isUnincorporated` is optional and left unchanged when omitted. Any member of the organization, a partner Owner/Admin or an API key for the organization may edit addresses. A partner Member gets 403, and you get 404 if you do not own the organization.

Category: Addresses

Request body:
addresses (TransactionAddressUpdateItem[], required) - The transaction addresses to update; at most 1000 per request.
  id (string) - Id of the address to update, or `null` to upsert by transaction and type.
  transactionId (string, required) - Id of the transaction the address belongs to.
  type (PublicAddressTypeEnum, required) - Address role to set (`SHIP_TO` or `BILL_TO`).
    allowed values: BILL_TO, SHIP_TO, SHIP_FROM, BILL_FROM
  street1 (string) - First line of the street address. Omit or send `null` to clear; send a value to set.
  street2 (string) - Second line of the street address. Omit or send `null` to clear; send a value to set.
  city (string) - City or locality. Omit or send `null` to clear; send a value to set.
  county (string) - County or district. Omit or send `null` to clear; send a value to set.
  state (string) - State or province code. Omit or send `null` to clear; send a value to set.
  postalCode (string) - Postal or ZIP code. Omit or send `null` to clear; send a value to set.
  countryCode (string) - ISO 3166-1 alpha-2 country code, such as `US`, `CA` or `GB`. Omit or send `null` to clear; send a value to set.
  fullAddress (string) - Single-line full address. Omit or send `null` to clear; send a value to set.
  phone (string) - Contact phone for the address. Omit or send `null` to clear; send a value to set.
  isUnincorporated (boolean) - When `true`, city-level tax rates are not applied to this address. Omit or send `null` to leave the stored value unchanged; send `false` to clear it.

Response fields:
[truncated, see the reference page]

---

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