Skip to main content

Classifier System

Different data sources often describe the same real-world concepts using different labels or formats. G-BRIS introduces classifiers to ensure consistent interpretation of those values across jurisdictions and sources.

Classifiers allow API consumers to work with stable identifiers (key) while optionally displaying user-friendly labels or metadata (meta).

Why Use Classifiers​

Without classifiers, comparing attributes like legal form or identifier type across sources and countries would be error-prone or ambiguous.

For example:

  • One source might label a Danish partnership as "p/s"
  • Another source may represent the same legal form as "9KSX"

G-BRIS resolves this by applying a controlled vocabulary — a classifier — to each such value.

Classifier Format​

Each classifier-controlled field follows this structure:

{
  "classifier": {
    "key": "lei_code",
    "meta": {
      "name": "GLEIF"
    }
  }
}

Classifier-Controlled Fields​

  • identifiers[].classifier — Describes the type of identifier.
  • legal_form_classifier — The legal form of the entity.
info

Classifier values are strictly validated. If a field cannot be mapped to a known classifier, it is discarded from the final output. This ensures only clean, standardized data is returned via the API.