TaxResidency
Tax residency information for a customer. Used for regulatory compliance and tax reporting purposes.
type TaxResidency {
country: Country!
id: String!
taxNumber: String
}
Fields
TaxResidency.country ● Country! non-null scalar
Country of tax residency. Must be a valid ISO 3166-1 alpha-2 country code.
Example: "DE" for Germany
TaxResidency.id ● String! non-null scalar
Tax identification number or equivalent. Format varies by country according to local regulations.
Examples:
- Germany: _Steueridentifikationsnummer_ (11 digits)
- France: _Numéro fiscal de référence_ (13 characters)
TaxResidency.taxNumber ● String scalar
Additional tax number if required by the country. Some jurisdictions require multiple tax identifiers.
Example: Local tax office number