API Reference
Egon API Reference
Suggest, validate, and normalize addresses and related data. Every service is a POST endpoint that accepts and returns JSON.
Services
5 service families • 24 endpoints. Click any service to view its operations.
Suggest Services
11 endpointsPredictive autocomplete for countries, cities, streets, postal codes, and house numbers. Results update as you type, so users enter valid addresses.
/api/suggest/countryThe Suggest Country endpoint provides predictive autocomplete and search over world countries, with names in many languages, ISO codes, and Egon IDs.POST/api/suggest/stateThe Suggest State endpoint provides predictive autocomplete and search for states and federal states, returning names, codes, and Egon IDs.POST/api/suggest/regionThe Suggest Region endpoint provides predictive autocomplete and search for regions, returning each matching region with its name and Egon ID.POST/api/suggest/provinceThe Suggest Province endpoint provides predictive autocomplete and search for provinces, returning each match with its province code and Egon ID.POST/api/suggest/cityThe Suggest City endpoint provides predictive autocomplete and search for cities and municipalities, with their postal code and Egon ID.POST/api/suggest/district1The Suggest District 1 endpoint provides predictive autocomplete and search for first-level districts, such as localities and municipalities.POST/api/suggest/zipcodeThe Suggest Zipcode endpoint suggests postal codes at locality level (L) or at street level (S, available for GBR, IRL, NLD, and JPN).POST/api/suggest/zipcodeAllThe Suggest Zipcode All endpoint returns every house-number range for a city, street, or house number, with its parity and range type.POST/api/suggest/streetThe Suggest Street endpoint provides predictive autocomplete for street search.POST/api/suggest/hnThe Suggest House Number endpoint suggests house numbers for a street, including numbers with exponents and kilometer markers.POST/api/suggest/birthLocalityThe Suggest Birth Locality endpoint searches official and historical birth localities and returns the corresponding Belfiore code.Validation Services
10 endpointsValidation and normalization of addresses, names, phones, emails, tax codes, and VAT numbers. Every result has quality flags and codes.
/api/normThe Address endpoint validates and normalizes an address, returning the street, house number, postal data, Egon codes, and geographic coordinates.POST/api/normValidate one or more email addresses and return normalized values together with syntax and domain quality indicators.POST/api/normValidate personal names, sole proprietorships, company names, co-holder names, and family surnames, and return normalized and structured output.POST/api/normValidate and normalize telephone numbers provided either as individual international and national prefix components or as a single full number.POST/api/normCalculate an Italian tax code (Codice Fiscale) from surname, name, gender, date of birth, and city of birth, with a quality flag for the result.POST/api/normCheck the formal validity and structure of an Italian tax code (Codice Fiscale) and get a quality flag and code that describe the result.POST/api/normExtract gender, date of birth, and place of birth (city and province) from an Italian tax code (Codice Fiscale), with a quality flag.POST/api/normCompare a tax code against a person's identifying data, including name, gender, date of birth, and birthplace.POST/api/normCheck the structure and formal validity of a VAT number (Partita IVA) and get a quality flag and code that describe the result of the check.POST/api/normValidate and enrich company data from a VAT number: official business name, legal address, phone numbers, PEC email, and ATECO codes.Single Line Service
1 endpointRecognition and normalization of a complete address written as a single free-text string. Returns a list of normalized candidates to choose from.
Reverse Geocoding
1 endpointConversion of geographic coordinates into normalized addresses. Returns the nearest house numbers with street, postal code, and distance.
Map Broker Services
1 endpointRoute calculation and distance matrix services. The Routing endpoint calculates routes for a generic vehicle or for pedestrians.
Quality Indicators & Domains
Consult validation quality result codes and standardized domain dictionaries used across Egon services.
OpenAPI Schema
The entire Egon API contract is defined using the modern OpenAPI 3.1 specification. The full schema is available at /openapi.json and /openapi.yaml.
curl -O https://documentation.egon.com/openapi.json
curl -O https://documentation.egon.com/openapi.yaml
Service Family Schemas
Download isolated OpenAPI specifications containing only the endpoints and schemas for a specific service family.
Help & Support
Need assistance with integration, enterprise licensing, or technical inquiries? Our team and resources are at your service.