Skip to main content

Tax residency

The tax residency node captures changes the customer has made to their declared tax residencies as part of this bank report.

Shape​

taxResidencyChanges exposes:

  • id
  • taxResidencyRelation — a list of OrganizationChangeTaxResidency entries. Only relations whose state is not Removed are returned; the removed ones are filtered out server‑side.

Each entry on taxResidencyRelation carries:

  • tin — the tax identification number for that jurisdiction.
  • country — the country relation; project alpha2 and name for the usual identifiers.

When the node is populated​

The node is meaningful only when isTaxResidencyRequired is true on the parent bank report.

Where to query​

See Querying tax residency. To reject a package because the tax residency declaration is unacceptable, set rejectTaxResidency: true on rejectBankPackageById.