> ## 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 is used to define a code for a specific context.

## Schema ID

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

## Properties

| Title | Property | Type | Description |
| - | - | - | - |
| UUID | `uuid` | string | Universally Unique Identifier. |
| Label | `label` | string | Optional label useful for non-standard identities to give a bit more context. |
| Scope | `scope` | [cbc.Key](/draft-0/cbc/key) | Scope defines the context in which this identity is meant to be used. |
| Country | `country` | [l10n.ISOCountryCode](/draft-0/l10n/i_s_o_country_code) | Country from which the identity was issued. |
| Key | `key` | [cbc.Key](/draft-0/cbc/key) | Uniquely classify this identity using a key instead of a Type. |
| Type | `type` | [cbc.Code](/draft-0/cbc/code) | The type of Code being represented and usually specific for a particular context, country, or tax regime, and cannot be used alongside the key. |
| Code | `code` | [cbc.Code](/draft-0/cbc/code) | The actual value of the identity code. |
| Description | `description` | string | Description adds details about what the code could mean or imply |
| Extensions | `ext` | [tax.Extensions](/draft-0/tax/extensions) | Ext provides a way to add additional information to the identity. |

## Scope Values

| Value | Description |
| - | - |
| `tax` | Tax |
| `legal` | Legal |

## Validation Rules

| Field | Test | Validation Code / Message |
| - | - | - |
| <small>Identity</small> | <ul class="gobl-test"><li>Key and type must not be used together</li></ul> | `GOBL-ORG-IDENTITY-03`<br />Identity must have either a key or type defined, but not both |
| `code` | <ul class="gobl-test"><li class="gobl-test-present">Present</li></ul> | `GOBL-ORG-IDENTITY-01`<br />Identity code must be provided |
| `scope` | <ul class="gobl-test"><li>One of \[tax, legal]</li></ul> | `GOBL-ORG-IDENTITY-02`<br />Identity scope when provided must be either 'tax' or 'legal' |


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