# Person tax identifications

## Create a tax identification for a person

 - [POST /v1/persons/{person_id}/tax_identifications](https://docs.solarisgroup.com/api-reference/onboarding/persons/person-tax-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1tax_identifications/post.md): Submits a tax identification for a person. The first tax identification to be submitted for a person must be their primary tax identification. If you add another tax identification with the value of  set to , then the previous primary tax identification will become a secondary tax identification (i.e., its  value will change to ). You may only create one tax identification per country per customer.  When creating a tax identification for a person, always collect the  value from the person separately from their residence country in your frontend. Do not default to the customer's physical residence (i.e., the  value of their  resource).

## Index tax identifications for a person

 - [GET /v1/persons/{person_id}/tax_identifications](https://docs.solarisgroup.com/api-reference/onboarding/persons/person-tax-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1tax_identifications/get.md): Returns an array containing all of the given person's tax identifications.

## Retrieve a person's tax identification

 - [GET /v1/persons/{person_id}/tax_identifications/{id}](https://docs.solarisgroup.com/api-reference/onboarding/persons/person-tax-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1tax_identifications~1%7Bid%7D/get.md): Returns the person tax identification specified in the request URL.

## Update a person's tax identification

 - [PATCH /v1/persons/{person_id}/tax_identifications/{id}](https://docs.solarisgroup.com/api-reference/onboarding/persons/person-tax-identifications/paths/~1v1~1persons~1%7Bperson_id%7D~1tax_identifications~1%7Bid%7D/patch.md): Modifies one or more properties of a person's tax identification.