> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gobl.org/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'  |