Quality Indicators
Quality indicators describe how Egon validated, changed, rejected, or approximated an input value during postal standardization and data validation services.
How to Read an Indicator
Each quality result in an API response contains three key elements:
| Field | Type | Description |
|---|---|---|
flag | String | High-level validation status indicating whether data was unchanged, corrected, or rejected |
code | Number | Granular error or quality rule code specifying the exact operation performed |
description | String | Human-readable explanation of the validation outcome |
Flag Values
The high-level flag summarizes the overall validation outcome:
| Flag | Status | Meaning |
|---|---|---|
| 0 · OK | Validated without changes | The input value perfectly matched reference authority databases and required no alterations. |
| 1 · Changed | Validated with changes | The input value was recognized and corrected, completed, or standardized according to official postal rules. |
| 2/3 · Not valid | Not validated | The value could not be validated due to ambiguity, syntax errors, missing mandatory elements, or no matching records found. |
Indicator Catalogs
/quality-indicators/addressDetailed quality codes for locality, street name, postal code, and house-number validation.
/quality-indicators/birthQuality indicators returned for birth-date coherence and birthplace validation.
/quality-indicators/emailSyntax validation, domain verification, certified PEC identification, and disposable email detection.
/quality-indicators/geocodingCoordinate sources (TomTom, HERE, Egon, cadastre) and spatial precision approximation levels.
/quality-indicators/personName and surname parsing, academic title detection, corporate legal forms, and gender consistency.
/quality-indicators/phoneTelephone number standardization, international prefix addition, and geographical area code checks.
/quality-indicators/tax-codeItalian fiscal code calculation, checksum verification, omocody resolution, and identity checks.
/quality-indicators/vatVAT number syntax validation, European VIES cross-checks, and corporate registry verification.
Also in Reference
Complementary reference guide and data dictionary: