> ## Documentation Index
> Fetch the complete documentation index at: https://gobl-cli-install-gobl-dev.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Identity

Identity stores the details required to identify an entity for tax purposes in a specific country.

## Schema ID

`https://gobl.org/draft-0/tax/identity`

## Properties

| Title | Property | Type | Description |
| - | - | - | - |
| Country Code | `country` | [l10n.TaxCountryCode](/draft-0/l10n/tax_country_code) | Tax country code for Where the tax identity was issued. |
| Code | `code` | [cbc.Code](/draft-0/cbc/code) | Normalized code shown on the original identity document. |
| Scheme | `scheme` | [cbc.Code](/draft-0/cbc/code) | Scheme is an optional field that may be used to override the tax regime's default tax scheme. Many electronic formats such as UBL or CII define an equivalent field. Examples: `VAT`, `GST`, `ST`, etc. |
| Type | `type` | [cbc.Key](/draft-0/cbc/key) | Type is set according to the requirements of each regime, some have a single tax document type code, others require a choice to be made. Deprecated: Tax Identities should only be used for VAT or similar codes for companies. Use the identities array for other types of identification. |

## Validation Rules

| Field | Test | Validation Code / Message |
| - | - | - |
| `country` | <ul class="gobl-test"><li class="gobl-test-present">Present</li></ul> | `GOBL-TAX-IDENTITY-01`<br />Tax id country code is always required |
| `code` | <ul class="gobl-test"><li>Matches ^\[A-Z0-9Ñ&]+\$</li></ul> | `GOBL-TAX-IDENTITY-02`<br />Tax id code must have a valid format |
| `scheme` | <ul class="gobl-test"><li>Matches ^\[A-ZÑa-z0-9]+(\[.-:/,\_& ]?\[A-ZÑa-z0-9]+)\*\$</li></ul> | `GOBL-TAX-IDENTITY-03`<br />Tax id scheme must be a valid code |
| `code` | <ul class="gobl-test"><li>Code in \[EL]</li><li>Valid</li></ul> | `GOBL-GR-TAX-IDENTITY-01`<br />Invalid Greek VAT identity code |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.