Users & Accounts Management

Tax Residencies

Download Spec

All tax residencies related paths.

get/users/{user_id}/tax_residencies

Retrieve tax residencies

user_idstring

required

User unique identifier.

Format: uuid

Responses

Response examples

User tax residencies

{
  "created_at": "2021-07-21T14:10:00.00Z",
  "updated_at": "2021-07-21T14:10:00.00Z",
  "status": "ACTIVE",
  "tax_residencies": [
    {
      "country": "IT",
      "tax_identifier_number": "LLLLLL99L99L999L"
    },
    {
      "country": "FR",
      "missing_tin_reason": "COUNTRY_HAS_NO_TIN"
    },
    {
      "country": "DE",
      "tax_identifier_number": "12345678901"
    }
  ]
}

post/users/{user_id}/tax_residencies

Update tax residencies

tax_residenciesarray

required

Must match one of

Responses

Request examples

{
  "tax_residencies": [
    {
      "country": "DE",
      "tax_identifier_number": "12345678901"
    }
  ]
}

Response examples

User tax residencies

{
  "created_at": "2021-07-21T14:10:00.00Z",
  "updated_at": "2021-07-21T14:10:00.00Z",
  "tax_residencies": [
    {
      "country": "AT",
      "missing_tin_reason": "TIN_NOT_YET_ASSIGNED"
    },
    {
      "country": "DE",
      "tax_identifier_number": "12345678901"
    }
  ],
  "status": "ACTIVE"
}

Was this page helpful?