# Update transaction addresses in a batch

> PUT /addresses/transactions

Source: https://docs.trykintsugi.com/reference/2026-07-21/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`. Owner/Admin only: returns 403 if your credential may read the organization but is not permitted to edit addresses, and 404 if you do not own the resolved 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.
  country (string) - ISO-3166 alpha-2 country code. 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.

Response fields:
addressId (string) - Id of the address the outcome is for, or `null` for an upsert where no `id` was sent. Correlate a `null` result by its position in the request.
status (PublicAddressUpdateStatusEnum, required) - Whether the address was updated (`UPDATED`) or failed (`FAILED`).
  allowed values: UPDATED, FAILED

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

---

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