Identifier

A unique identifier issued by a specific system for organizations or persons - business IDs, tax numbers, social security numbers, passport numbers, etc. Supports all country-specific identification systems

8 properties

Schema

Properties

Property	Type	Mode	Description	Required
system	string	stored	Identification system or authority (Organizations: 'SIREN', 'SIRET', 'VAT', 'EIN', 'DUNS', 'LEI' \| Persons: 'SSN', 'NIN', 'PASSPORT', 'DRIVERS_LICENSE') Example: `"SIREN"`	Required
value	string	stored	The actual identifier value Example: `"123456789"`	Required
type	string	enum	Type or category of identifier Values: `tax, registration, legal, financial, national-id, travel-document, license` Example: `"registration"`	Optional
country	Country	stored	Country where this identifier is valid (reference to Country entity)	Optional
issuer	string	stored	Organization or authority that issued the identifier Example: `"INSEE France"`	Optional
label	string	stored	Human-readable label for this identifier Example: `"French Business Registration Number"`	Optional
period	Period	stored	Period during which this identifier is valid	Optional
use	string	enum	Purpose of this identifier Values: `official, temp, secondary` Example: `"official"`	Optional

Examples

Example 1

{
  "@type": "Identifier",
  "system": "SIREN",
  "value": "123456789",
  "type": "registration",
  "country": {
    "@type": "Country",
    "code": "FR",
    "name": "France"
  },
  "issuer": "INSEE France",
  "label": "French Business Registration Number",
  "use": "official"
}

Example 2

{
  "@type": "Identifier",
  "system": "SIRET",
  "value": "12345678900012",
  "type": "registration",
  "country": {
    "@type": "Country",
    "code": "FR",
    "name": "France"
  },
  "label": "French Establishment Number"
}

Example 3

{
  "@type": "Identifier",
  "system": "VAT",
  "value": "FR12345678901",
  "type": "tax",
  "country": {
    "@type": "Country",
    "code": "FR",
    "name": "France"
  },
  "label": "EU VAT Number"
}

Example 4

{
  "@type": "Identifier",
  "system": "EIN",
  "value": "12-3456789",
  "type": "tax",
  "country": {
    "@type": "Country",
    "code": "US",
    "name": "United States of America"
  },
  "issuer": "IRS",
  "label": "US Employer Identification Number"
}

Example 5

{
  "@type": "Identifier",
  "system": "DUNS",
  "value": "123456789",
  "type": "financial",
  "issuer": "Dun & Bradstreet",
  "label": "D-U-N-S Number"
}

Example 6

{
  "@type": "Identifier",
  "system": "LEI",
  "value": "123456789012ABCDEFGH12",
  "type": "financial",
  "label": "Legal Entity Identifier"
}

Example 7

{
  "@type": "Identifier",
  "system": "SSN",
  "value": "123-45-6789",
  "type": "national-id",
  "country": {
    "@type": "Country",
    "code": "US",
    "name": "United States of America"
  },
  "issuer": "Social Security Administration",
  "label": "US Social Security Number"
}

Example 8

{
  "@type": "Identifier",
  "system": "PASSPORT",
  "value": "AB1234567",
  "type": "travel-document",
  "country": {
    "@type": "Country",
    "code": "FR",
    "name": "France"
  },
  "issuer": "République Française",
  "label": "French Passport"
}

Example 9

{
  "@type": "Identifier",
  "system": "DRIVERS_LICENSE",
  "value": "D1234567",
  "type": "license",
  "country": {
    "@type": "Country",
    "code": "US",
    "name": "United States of America"
  },
  "issuer": "California DMV",
  "label": "California Driver's License"
}

Example 10

{
  "@type": "Identifier",
  "system": "NIN",
  "value": "AB123456C",
  "type": "national-id",
  "country": {
    "@type": "Country",
    "code": "GB",
    "name": "United Kingdom"
  },
  "issuer": "HMRC",
  "label": "UK National Insurance Number"
}