# Egon API Reference > Suggest, validate, and normalize addresses and related data. Every service is a POST endpoint that accepts and returns JSON. Suggest, validate, and normalize addresses and related data. Every service is a `POST` endpoint that accepts and returns JSON. ## Base URL - Default: `https://{host}:{port}/Egon`. Replace `{host}` and `{port}` with the address of your Egon instance. - `/api/routes`: `https://{host}:{port}/EgonMbk`. Replace `{host}` and `{port}` with the address of your Egon Map Broker instance. ## Authentication Authentication token sent in the `token` request header. ```bash curl -X POST "https://{host}:{port}/Egon/api/suggest/country" \ -H "token: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"data":{"query":"Ital"}}' ``` ## Services ### Suggest Services Predictive autocomplete for countries, cities, streets, postal codes, and house numbers. Results update as you type, so users enter valid addresses. - [Suggest Country](https://documentation.egon.com/docs/api/country.md): The Suggest Country endpoint provides predictive autocomplete and search over world countries, with names in many languages, ISO codes, and Egon IDs. (`POST /api/suggest/country`) - [Suggest State](https://documentation.egon.com/docs/api/state.md): The Suggest State endpoint provides predictive autocomplete and search for states and federal states, returning names, codes, and Egon IDs. (`POST /api/suggest/state`) - [Suggest Region](https://documentation.egon.com/docs/api/region.md): The Suggest Region endpoint provides predictive autocomplete and search for regions, returning each matching region with its name and Egon ID. (`POST /api/suggest/region`) - [Suggest Province](https://documentation.egon.com/docs/api/province.md): The Suggest Province endpoint provides predictive autocomplete and search for provinces, returning each match with its province code and Egon ID. (`POST /api/suggest/province`) - [Suggest City](https://documentation.egon.com/docs/api/city.md): The Suggest City endpoint provides predictive autocomplete and search for cities and municipalities, with their postal code and Egon ID. (`POST /api/suggest/city`) - [Suggest District 1](https://documentation.egon.com/docs/api/district-1.md): The Suggest District 1 endpoint provides predictive autocomplete and search for first-level districts, such as localities and municipalities. (`POST /api/suggest/district1`) - [Suggest Zipcode](https://documentation.egon.com/docs/api/zipcode.md): The 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/zipcode`) - [Suggest Zipcode All](https://documentation.egon.com/docs/api/zipcode-all.md): The 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/zipcodeAll`) - [Suggest Street](https://documentation.egon.com/docs/api/street.md): The Suggest Street endpoint provides predictive autocomplete for street search. (`POST /api/suggest/street`) - [Suggest House Number](https://documentation.egon.com/docs/api/hn.md): The Suggest House Number endpoint suggests house numbers for a street, including numbers with exponents and kilometer markers. (`POST /api/suggest/hn`) - [Suggest Birth Locality](https://documentation.egon.com/docs/api/birth-locality.md): The Suggest Birth Locality endpoint searches official and historical birth localities and returns the corresponding Belfiore code. (`POST /api/suggest/birthLocality`) ### Validation Services Validation and normalization of addresses, names, phones, emails, tax codes, and VAT numbers. Every result has quality flags and codes. - [Address](https://documentation.egon.com/docs/api/address.md): The Address endpoint validates and normalizes an address, returning the street, house number, postal data, Egon codes, and geographic coordinates. (`POST /api/norm`) - [Email](https://documentation.egon.com/docs/api/email.md): Validate one or more email addresses and return normalized values together with syntax and domain quality indicators. (`POST /api/norm`) - [Name](https://documentation.egon.com/docs/api/name.md): Validate personal names, sole proprietorships, company names, co-holder names, and family surnames, and return normalized and structured output. (`POST /api/norm`) - [Phone](https://documentation.egon.com/docs/api/phone.md): Validate and normalize telephone numbers provided either as individual international and national prefix components or as a single full number. (`POST /api/norm`) - [Tax Code Calculation](https://documentation.egon.com/docs/api/tax-code-calc.md): Calculate 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/norm`) - [Tax Code Validation](https://documentation.egon.com/docs/api/tax-code-check.md): Check 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/norm`) - [Tax Code Extraction](https://documentation.egon.com/docs/api/tax-code-extract.md): Extract gender, date of birth, and place of birth (city and province) from an Italian tax code (Codice Fiscale), with a quality flag. (`POST /api/norm`) - [Tax Code Verification](https://documentation.egon.com/docs/api/tax-code-match.md): Compare a tax code against a person's identifying data, including name, gender, date of birth, and birthplace. (`POST /api/norm`) - [VAT Validation](https://documentation.egon.com/docs/api/vat-check.md): Check 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/norm`) - [VAT Extraction](https://documentation.egon.com/docs/api/vat-ext.md): Validate and enrich company data from a VAT number: official business name, legal address, phone numbers, PEC email, and ATECO codes. (`POST /api/norm`) ### Single Line Service Recognition and normalization of a complete address written as a single free-text string. Returns a list of normalized candidates to choose from. - [Full Address](https://documentation.egon.com/docs/api/full-address.md): The Full Address endpoint parses a complete address written as a single free-text string and returns a list of normalized candidate addresses. (`POST /api/single-line/full-address`) ### Reverse Geocoding Conversion of geographic coordinates into normalized addresses. Returns the nearest house numbers with street, postal code, and distance. - [Address from Coordinates](https://documentation.egon.com/docs/api/reverse.md): The Reverse geocoding service retrieves address candidates from geographic coordinates, with street, house number, postal code, and distance. (`POST /api/revGeo`) ### Map Broker Services Route calculation and distance matrix services. The Routing endpoint calculates routes for a generic vehicle or for pedestrians. - [Routing](https://documentation.egon.com/docs/api/routing.md): Calculate a route between an origin and a destination for a generic vehicle or a pedestrian, based on the HERE Routing API v8. (`POST /api/routes`) ## Reference - [Quality Indicators](https://documentation.egon.com/docs/quality-indicators.md): Detailed validation flags (0, 1, 2/3) and outcome codes for addresses, geocoding, tax codes, and VAT. - [Domains & Dictionaries](https://documentation.egon.com/docs/domains.md): Standardized domain codes used in request and response fields (administrative codes, person types, phone lines). ## OpenAPI schema The full OpenAPI 3.1.0 schema is available at https://documentation.egon.com/openapi.json and https://documentation.egon.com/openapi.yaml. Per-family specifications are available under `https://documentation.egon.com/openapi/.{json,yaml}`. ## Help & Support Need assistance with integration, enterprise licensing, or technical inquiries? Our team and resources are at your service. - [Egon Website](https://www.egon.com/): Discover Egon's suite of enterprise data-quality solutions, customer success stories, and product capabilities. - [Contact Us!](https://www.egon.com/company/contact-us): Get in touch with our engineering and integration team to learn more about our services and request dedicated support.