# Egon Docs > Verify, correct, and complete addresses in real time, with a single API. The full OpenAPI schema is available at https://documentation.egon.com/openapi.json. Each page below links to its markdown version. ## API Reference - [Egon API Reference](https://documentation.egon.com/docs/api.md): Suggest, validate, and normalize addresses and related data. Every service is a POST endpoint that accepts and returns JSON. ## Suggest Services - [Suggest Services](https://documentation.egon.com/docs/api/suggest-services.md): 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. - [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. - [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. - [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. - [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. - [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. - [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). - [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. - [Suggest Street](https://documentation.egon.com/docs/api/street.md): The Suggest Street endpoint provides predictive autocomplete for street search. - [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. - [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. ## Validation Services - [Validation Services](https://documentation.egon.com/docs/api/validation-services.md): 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. - [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. - [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. - [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. - [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. - [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. - [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. - [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. - [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. - [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. ## Single Line Service - [Single Line Service](https://documentation.egon.com/docs/api/single-line-service.md): 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. ## Reverse Geocoding - [Reverse Geocoding](https://documentation.egon.com/docs/api/reverse-geocoding.md): 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. ## Map Broker Services - [Map Broker Services](https://documentation.egon.com/docs/api/map-broker-services.md): 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. ## Quality Indicators - [Quality Indicators](https://documentation.egon.com/docs/quality-indicators.md): Reference guide to Egon quality indicators: how each code shows whether an input value was validated, corrected, rejected, or approximated. - [Address Quality Indicators](https://documentation.egon.com/docs/quality-indicators/address.md): Quality indicators returned by Egon Address and Single Line services for locality, street, postal code, and house-number validation. - [Birth Quality Indicators](https://documentation.egon.com/docs/quality-indicators/birth.md): Quality indicator codes returned by Egon Validation services for birth-date and birthplace validation, with the meaning of each code. - [Email Quality Indicators](https://documentation.egon.com/docs/quality-indicators/email.md): Quality indicator codes returned in quality.emails by the Egon Email validation service, with the meaning of each code. - [Geocoding Quality Indicators](https://documentation.egon.com/docs/quality-indicators/geocoding.md): Reference values for the coordinate sources, provider datasets, and approximation levels of geographic coordinates returned by Egon. - [Person Quality Indicators](https://documentation.egon.com/docs/quality-indicators/person.md): Quality indicator codes returned by Egon Validation services for person, name, and legal entity validation, with the meaning of each code. - [Phone Quality Indicators](https://documentation.egon.com/docs/quality-indicators/phone.md): Quality indicator codes returned in quality.phones by the Egon Phone validation service, with the meaning of each code. - [Tax Code Quality Indicators](https://documentation.egon.com/docs/quality-indicators/tax-code.md): Quality indicator codes returned by Egon Tax Code services when calculating, extracting, checking, and matching Italian tax codes. - [VAT Quality Indicators](https://documentation.egon.com/docs/quality-indicators/vat.md): Quality indicator codes returned by Egon VAT services for VAT number validation and company data extraction, with the meaning of each code. ## Domains & Dictionaries - [Domains & Dictionaries](https://documentation.egon.com/docs/domains.md): Reference guide to Egon domain codes, territorial dictionaries, and lookup tables: the allowed values of type fields in API requests and responses. - [Adm Code Domain](https://documentation.egon.com/docs/domains/adm-code.md): Allowed values for the administrative code type field returned in Egon normalized address data, with the meaning of each value. - [Code Domain](https://documentation.egon.com/docs/domains/code.md): Allowed values for code-type fields such as cod_type and type in validation requests and responses: tax codes, VAT numbers, web addresses, and Atec... - [Email Domain](https://documentation.egon.com/docs/domains/email.md): Allowed values for the email address type field returned by Egon validation and enrichment services, with the meaning of each value. - [Name & Person Domain](https://documentation.egon.com/docs/domains/name.md): Allowed values for the type_ana and gender fields used in Egon name validation requests and responses, with the meaning of each value. - [Phone Domain](https://documentation.egon.com/docs/domains/phone.md): Allowed values for the phone number type field returned by Egon phone validation and enrichment services, with the meaning of each value. ## Batch Processing - [Batch Processing](https://documentation.egon.com/docs/batch.md): Technical overview of Egon Batch Processing (PPN): high-throughput asynchronous address normalization and geocoding of large datasets via SFTP. - [SFTP Setup & Workflow](https://documentation.egon.com/docs/batch/sftp-workflow.md): SFTP connection parameters, directory topology, file pairing rules, and default descriptor options for Egon Batch address processing. - [Input Specifications & TRK Mapping](https://documentation.egon.com/docs/batch/input-specifications.md): CSV formatting rules, ZIP archive packaging, and the complete .trk column mapping reference for Egon Batch input files sent via SFTP. - [Output Schema & Codes](https://documentation.egon.com/docs/batch/output-specifications.md): Complete schema of the enriched output file, including normalized postal fields, spatial coordinates, and quality match codes. - [Batch Processing Playground](https://documentation.egon.com/docs/batch/playground.md): Map your CSV columns, generate the Egon Batch .trk descriptor, and validate it before you upload your dataset to the SFTP input folder. ## Build with AI - [Build with AI](https://documentation.egon.com/docs/build-with-ai.md): Use the Egon documentation and OpenAPI schema with ChatGPT, Claude, Cursor, GitHub Copilot, and AI app builders. - [Resources for AI](https://documentation.egon.com/docs/build-with-ai/resources.md): The machine-readable files every build of the Egon documentation publishes for AI tools: llms.txt, markdown pages, the OpenAPI schema, and skills. - [Chat Assistants](https://documentation.egon.com/docs/build-with-ai/chat-assistants.md): Ask ChatGPT, Claude, or Cursor about the Egon API using the documentation as context, for a single page or for the whole API through llms.txt. - [Coding Agents](https://documentation.egon.com/docs/build-with-ai/coding-agents.md): Set up Claude Code, Cursor, GitHub Copilot, or Codex with the Egon documentation and OpenAPI schema, so they write code that matches the Egon API. - [Agent Skills](https://documentation.egon.com/docs/build-with-ai/skills.md): Install the Egon agent skills in Claude Code, Codex, Cursor, and other coding agents, so they know the API, Batch, the auth, and key safety. - [App Builders](https://documentation.egon.com/docs/build-with-ai/app-builders.md): Add Egon address validation to apps built with Lovable, v0, or Bolt: store your API key as a secret and paste a ready-made prompt. - [Prompt Library](https://documentation.egon.com/docs/build-with-ai/prompt-library.md): Ready-made prompts for common Egon integrations, such as address autocomplete and validation, to paste into coding agents and AI app builders. - [API Key Safety](https://documentation.egon.com/docs/build-with-ai/api-key-safety.md): Keep your Egon API key out of prompts, chats, and browser code when you build with AI: store it as a secret and call Egon from the server. ## Optional - [Suggest Services OpenAPI (JSON)](https://documentation.egon.com/openapi/suggest-services.json): OpenAPI schema of the Suggest Services family. - [Suggest Services OpenAPI (YAML)](https://documentation.egon.com/openapi/suggest-services.yaml): OpenAPI schema of the Suggest Services family. - [Validation Services OpenAPI (JSON)](https://documentation.egon.com/openapi/validation-services.json): OpenAPI schema of the Validation Services family. - [Validation Services OpenAPI (YAML)](https://documentation.egon.com/openapi/validation-services.yaml): OpenAPI schema of the Validation Services family. - [Single Line Service OpenAPI (JSON)](https://documentation.egon.com/openapi/single-line-service.json): OpenAPI schema of the Single Line Service family. - [Single Line Service OpenAPI (YAML)](https://documentation.egon.com/openapi/single-line-service.yaml): OpenAPI schema of the Single Line Service family. - [Reverse Geocoding OpenAPI (JSON)](https://documentation.egon.com/openapi/reverse-geocoding.json): OpenAPI schema of the Reverse Geocoding family. - [Reverse Geocoding OpenAPI (YAML)](https://documentation.egon.com/openapi/reverse-geocoding.yaml): OpenAPI schema of the Reverse Geocoding family. - [Map Broker Services OpenAPI (JSON)](https://documentation.egon.com/openapi/map-broker-services.json): OpenAPI schema of the Map Broker Services family. - [Map Broker Services OpenAPI (YAML)](https://documentation.egon.com/openapi/map-broker-services.yaml): OpenAPI schema of the Map Broker Services family.