openapi: 3.0.3 info: title: 'Egon API' description: 'This is the Egon API documentation.
This documentation aims to provide all the information you need to work with our API.' version: 2.0.0 servers: - url: 'https://api.egon.com' paths: /v3/suggest/address: get: summary: 'Address (full)' description: "

Suggestion for full address

\n\"Suggest" parameters: - in: query name: query description: 'Query string.' example: 'Via Roveggia 5c' required: true schema: type: string description: 'Query string.' example: 'Via Roveggia 5c' - in: query name: restrict_id description: 'ID of the territorial level.
Used for filtering the research by a certain territorial level.
Can accept multiple values: "38000000001", "72400000001".
It must be combined with restrict_level. This field is required when restrict_level is present. The value format is invalid.' example: '38000000001' required: false schema: type: string description: 'ID of the territorial level.
Used for filtering the research by a certain territorial level.
Can accept multiple values: "38000000001", "72400000001".
It must be combined with restrict_level. This field is required when restrict_level is present. The value format is invalid.' example: '38000000001' - in: query name: restrict_level description: 'Territorial level of restriction.
Used for filtering the research by a certain territorial level.
It must be combined with restrict_id.
Allowed values: state, region, province, city, district1. This field is required when restrict_id is present.' example: country required: false schema: type: string description: 'Territorial level of restriction.
Used for filtering the research by a certain territorial level.
It must be combined with restrict_id.
Allowed values: state, region, province, city, district1. This field is required when restrict_id is present.' example: country - in: header name: Authorization description: '' example: 'Bearer {YOUR_APP_KEY}' schema: type: string - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '' content: application/json: schema: type: array items: type: object example: - iso3: ITA level: street id: 38000073665 country: Italia region: Veneto province: Verona province_code: VR city: Verona zipcode: '37136' street: 'Via Roveggia' number: '5' exponent: c label: 'Via Roveggia 5c, 37136 Verona (VR) - Italia' - iso3: ITA level: street id: 38000860896 country: Italia region: Puglia province: Taranto province_code: TA city: Manduria district1: 'Torre Colimena' zipcode: '74024' street: 'Via 5C' number: '5' exponent: c label: 'Via 5C 5c, 74024 Manduria (TA) - Italia' - iso3: ECU level: street id: 21800019148 country: Ecuador province: Pichincha city: Cayambe street: 5C number: '5' exponent: c label: '5C 5c, Cayambe - Ecuador' - iso3: ECU level: street id: 21800012971 country: Ecuador province: Azuay city: Cuenca street: 5C number: '5' exponent: c label: '5C 5c, Cuenca - Ecuador' - iso3: ECU level: street id: 21800019281 country: Ecuador province: Pichincha city: Quito street: 5C number: '5' exponent: c label: '5C 5c, Quito - Ecuador' - iso3: MEX level: street id: 48404240605 country: México state: Yucatán state_code: YUC city: Kanasín zipcode: '97370' street: 'Calle 5C' number: '5' exponent: c label: 'Calle 5C 5c, 97370 Kanasín - México' - iso3: MEX level: street id: 48404245442 country: México state: Yucatán state_code: YUC city: Mérida zipcode: '97130' street: 'Calle 5C' number: '5' exponent: c label: 'Calle 5C 5c, 97130 Mérida - México' - iso3: MEX level: street id: 48404245443 country: México state: Yucatán state_code: YUC city: Mérida zipcode: '97133' street: 'Calle 5C' number: '5' exponent: c label: 'Calle 5C 5c, 97133 Mérida - México' - iso3: MEX level: street id: 48404245444 country: México state: Yucatán state_code: YUC city: Mérida zipcode: '97204' street: 'Calle 5C' number: '5' exponent: c label: 'Calle 5C 5c, 97204 Mérida - México' - iso3: MEX level: street id: 48404245445 country: México state: Yucatán state_code: YUC city: Mérida zipcode: '97217' street: 'Calle 5C' number: '5' exponent: c label: 'Calle 5C 5c, 97217 Mérida - México' 401: description: Unauthorized content: application/json: schema: type: object example: error: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' properties: error: type: object example: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' 400: description: 'Bad Request' content: application/json: schema: type: object example: error: code: 400 message: 'Missing the ''query''.' properties: error: type: object example: code: 400 message: 'Missing the ''query''.' tags: - 'Suggest V3 - OLD' /v3/suggest/country: get: summary: Country description: "

Suggestion for country

\n\"Country" parameters: - in: query name: query description: 'Query string.' example: Italia required: true schema: type: string description: 'Query string.' example: Italia - in: header name: Authorization description: '' example: 'Bearer {YOUR_APP_KEY}' schema: type: string - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '' content: application/json: schema: type: array items: type: object example: - iso3: ITA level: country id: 38000000001 country: Italia 401: description: Unauthorized content: application/json: schema: type: object example: error: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' properties: error: type: object example: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' tags: - 'Suggest V3 - OLD' /v3/suggest/state: get: summary: State description: '

Suggestion for state

' parameters: - in: query name: query description: 'Query string.' example: California required: true schema: type: string description: 'Query string.' example: California - in: query name: iso3 description: 'Country code (ISO 3166-1 alpha-3).' example: USA required: true schema: type: string description: 'Country code (ISO 3166-1 alpha-3).' example: USA - in: header name: Authorization description: '' example: 'Bearer {YOUR_APP_KEY}' schema: type: string - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '' content: application/json: schema: type: array items: type: object example: - iso3: USA level: state id: 84000000010 country: 'United States' state: California state_code: CA 401: description: Unauthorized content: application/json: schema: type: object example: error: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' properties: error: type: object example: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' tags: - 'Suggest V3 - OLD' /v3/suggest/region: get: summary: Region description: '

Suggestion for region

' parameters: - in: query name: query description: 'Query string.' example: Veneto required: true schema: type: string description: 'Query string.' example: Veneto - in: query name: iso3 description: 'Country code (ISO 3166-1 alpha-3).' example: ITA required: true schema: type: string description: 'Country code (ISO 3166-1 alpha-3).' example: ITA - in: header name: Authorization description: '' example: 'Bearer {YOUR_APP_KEY}' schema: type: string - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '' content: application/json: schema: type: array items: type: object example: - iso3: ITA level: region id: 38000000006 country: Italia region: Veneto 401: description: Unauthorized content: application/json: schema: type: object example: error: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' properties: error: type: object example: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' tags: - 'Suggest V3 - OLD' /v3/suggest/province: get: summary: Province description: '

Suggestion for province

' parameters: - in: query name: query description: 'Query string.' example: Verbano required: true schema: type: string description: 'Query string.' example: Verbano - in: query name: iso3 description: 'Country code (ISO 3166-1 alpha-3).' example: ITA required: true schema: type: string description: 'Country code (ISO 3166-1 alpha-3).' example: ITA - in: query name: restrict_id description: 'ID of the territorial level.
Used for filtering the research by a certain territorial level.' example: 38000000001 required: false schema: type: integer description: 'ID of the territorial level.
Used for filtering the research by a certain territorial level.' example: 38000000001 - in: header name: Authorization description: '' example: 'Bearer {YOUR_APP_KEY}' schema: type: string - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '' content: application/json: schema: type: array items: type: object example: - iso3: ITA level: province id: 38000000123 country: Italia region: Piemonte province: 'Verbano Cusio Ossola' province_code: VB 401: description: Unauthorized content: application/json: schema: type: object example: error: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' properties: error: type: object example: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' tags: - 'Suggest V3 - OLD' /v3/suggest/city: get: summary: City description: "

Suggestion for city

\n\"City" parameters: - in: query name: query description: 'Query string.' example: Vercelli required: true schema: type: string description: 'Query string.' example: Vercelli - in: query name: iso3 description: 'Country code (ISO 3166-1 alpha-3).' example: ITA required: true schema: type: string description: 'Country code (ISO 3166-1 alpha-3).' example: ITA - in: query name: restrict_id description: 'ID of the territorial level.
Used for filtering the research by a certain territorial level.' example: 38000000001 required: false schema: type: integer description: 'ID of the territorial level.
Used for filtering the research by a certain territorial level.' example: 38000000001 - in: header name: Authorization description: '' example: 'Bearer {YOUR_APP_KEY}' schema: type: string - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '' content: application/json: schema: type: array items: type: object example: - iso3: ITA level: city id: 38000001682 country: Italia region: Piemonte province: Vercelli province_code: VC city: Vercelli zipcode: '13100' - iso3: ITA level: city id: 38000001606 country: Italia region: Piemonte province: Vercelli province_code: VC city: 'Borgo Vercelli' zipcode: '13012' 401: description: Unauthorized content: application/json: schema: type: object example: error: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' properties: error: type: object example: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' tags: - 'Suggest V3 - OLD' /v3/suggest/district1: get: summary: District1 description: '

Suggestion for district level 1

' parameters: - in: query name: query description: 'Query string.' example: Milano required: true schema: type: string description: 'Query string.' example: Milano - in: query name: iso3 description: 'Country code (ISO 3166-1 alpha-3).' example: ITA required: true schema: type: string description: 'Country code (ISO 3166-1 alpha-3).' example: ITA - in: query name: restrict_id description: 'ID of the territorial level.
Used for filtering the research by a certain territorial level.' example: 38000000001 required: false schema: type: integer description: 'ID of the territorial level.
Used for filtering the research by a certain territorial level.' example: 38000000001 - in: header name: Authorization description: '' example: 'Bearer {YOUR_APP_KEY}' schema: type: string - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '' content: application/json: schema: type: array items: type: object example: - iso3: ITA level: district1 id: 38001363482 country: Italia region: Umbria province: Perugia province_code: PG city: Spoleto district1: Milano zipcode: '06049' - iso3: ITA level: district1 id: 38000022330 country: Italia region: Lombardia province: Milano province_code: MI city: Segrate district1: 'Milano Due' zipcode: '20054' - iso3: ITA level: district1 id: 38000009426 country: Italia region: Emilia-Romagna province: Ravenna province_code: RA city: Cervia district1: 'Milano Marittima' zipcode: '48015' - iso3: ITA level: district1 id: 38000019401 country: Italia region: Lombardia province: Milano province_code: MI city: Basiglio district1: 'Milano Tre' zipcode: '20079' - iso3: ITA level: district1 id: 38001129710 country: Italia region: Lombardia province: Milano province_code: MI city: Assago district1: Milanofiori zipcode: '20057' - iso3: ITA level: district1 id: 38001308925 country: Italia region: Piemonte province: Torino province_code: TO city: Torino district1: 'Barriera di Milano' zipcode: '10100' - iso3: ITA level: district1 id: 38001131341 country: Italia region: Veneto province: Verona province_code: VR city: Verona district1: 'Borgo Milano' zipcode: '37100' - iso3: ITA level: district1 id: 38001129711 country: Italia region: Lombardia province: Milano province_code: MI city: Assago district1: 'Centro Congressi Milanofiori' zipcode: '20057' - iso3: ITA level: district1 id: 38000017703 country: Italia region: 'Trentino-Alto Adige' province: Trento province_code: TN city: Sporminore district1: 'Maso Milano' zipcode: '38010' - iso3: ITA level: district1 id: 38000022199 country: Italia region: Lombardia province: Lodi province_code: LO city: 'Tavazzano con Villavesco' district1: 'Muzza di Milano' zipcode: '26838' 401: description: Unauthorized content: application/json: schema: type: object example: error: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' properties: error: type: object example: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' tags: - 'Suggest V3 - OLD' /v3/suggest/street: get: summary: Street description: "

Suggestion for street

\n\"Suggest" parameters: - in: query name: query description: 'Query string.' example: 'Via Roma' required: true schema: type: string description: 'Query string.' example: 'Via Roma' - in: query name: iso3 description: 'Country code (ISO 3166-1 alpha-3).' example: ITA required: true schema: type: string description: 'Country code (ISO 3166-1 alpha-3).' example: ITA - in: query name: restrict_id description: 'ID of the city level.
Used for filtering the research by a certain territorial level.' example: 38000004730 required: false schema: type: integer description: 'ID of the city level.
Used for filtering the research by a certain territorial level.' example: 38000004730 - in: header name: Authorization description: '' example: 'Bearer {YOUR_APP_KEY}' schema: type: string - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '' content: application/json: schema: type: array items: type: object example: - level: street id: 38000073652 region: Veneto province: Verona province_code: VR city: Verona street: 'Via Roma' zipcode: '37121' - level: street id: 38001142331 region: Veneto province: Verona province_code: VR city: Verona street: 'Via Romagna' zipcode: '37134' - level: street id: 38000073653 region: Veneto province: Verona province_code: VR city: Verona street: 'Via Beniamino Romagnoli' zipcode: '37139' 401: description: Unauthorized content: application/json: schema: type: object example: error: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' properties: error: type: object example: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' 400: description: 'Bad Request' content: application/json: schema: type: object example: error: code: 400 message: 'Missing the ''iso3''.' properties: error: type: object example: code: 400 message: 'Missing the ''iso3''.' tags: - 'Suggest V3 - OLD' /v3/suggest/zipcode: get: summary: Zipcode description: '

Suggestion for zipcode

' parameters: - in: query name: query description: 'Query string.' example: '42023' required: true schema: type: string description: 'Query string.' example: '42023' - in: query name: iso3 description: 'Country code (ISO 3166-1 alpha-3).' example: ITA required: true schema: type: string description: 'Country code (ISO 3166-1 alpha-3).' example: ITA - in: query name: zip_level description: 'Extraction level. It can be set to:
- L = Candidates at locality level
- S = Candidates at street level - used in GBR / IRL / NLD / JPN
Default: L.' example: L required: false schema: type: string description: 'Extraction level. It can be set to:
- L = Candidates at locality level
- S = Candidates at street level - used in GBR / IRL / NLD / JPN
Default: L.' example: L - in: header name: Authorization description: '' example: 'Bearer {YOUR_APP_KEY}' schema: type: string - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '' content: application/json: schema: type: array items: type: object example: - country: Italia region: Emilia-Romagna province: 'Reggio Emilia' level: city id: 38000005186 city: 'Cadelbosco di Sopra' city_id: 38000005186 zipcode: '42023' - country: Italia region: Emilia-Romagna province: 'Reggio Emilia' level: district1 id: 38000013982 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: Argine zipcode: '42023' - country: Italia region: Emilia-Romagna province: 'Reggio Emilia' level: district1 id: 38000013983 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: Seta zipcode: '42023' - country: Italia region: Emilia-Romagna province: 'Reggio Emilia' level: district1 id: 38000018193 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: 'Villa Seta' zipcode: '42023' - country: Italia region: Emilia-Romagna province: 'Reggio Emilia' level: district1 id: 38000022111 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: Zurco zipcode: '42023' - country: Italia region: Emilia-Romagna province: 'Reggio Emilia' level: district1 id: 38000027973 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: 'Cadelbosco di Sotto' zipcode: '42023' - country: Italia region: Emilia-Romagna province: 'Reggio Emilia' level: district1 id: 38000030577 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: 'Santa Vittoria' zipcode: '42023' - country: Italia region: Emilia-Romagna province: 'Reggio Emilia' level: district1 id: 38001352004 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: 'Argine Vecchio' zipcode: '42023' - country: Italia region: Emilia-Romagna province: 'Reggio Emilia' level: district1 id: 38001352005 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: Basetti zipcode: '42023' - country: Italia region: Emilia-Romagna province: 'Reggio Emilia' level: district1 id: 38001352006 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: Cantone zipcode: '42023' - country: Italia region: Emilia-Romagna province: 'Reggio Emilia' level: district1 id: 38001352007 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: 'La Madonnina' zipcode: '42023' - country: Italia region: Emilia-Romagna province: 'Reggio Emilia' level: district1 id: 38001352008 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: 'Ponte Forca' zipcode: '42023' - country: Italia region: Emilia-Romagna province: 'Reggio Emilia' level: district1 id: 38001352009 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: Quarti zipcode: '42023' - country: Italia region: Emilia-Romagna province: 'Reggio Emilia' level: district1 id: 38001352010 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: 'Stazione Bosco Sotto' zipcode: '42023' - country: Italia region: Emilia-Romagna province: 'Reggio Emilia' level: district1 id: 38001352011 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: 'Villa Argine' zipcode: '42023' - country: Italia region: Emilia-Romagna province: 'Reggio Emilia' level: district1 id: 38001470449 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: 'Corte Cantina' zipcode: '42023' - country: Italia region: Emilia-Romagna province: 'Reggio Emilia' level: district1 id: 38001470450 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: 'La Tomba' zipcode: '42023' - country: Italia region: Emilia-Romagna province: 'Reggio Emilia' level: district1 id: 38001470451 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: Florida zipcode: '42023' - country: Italia region: Emilia-Romagna province: 'Reggio Emilia' level: district1 id: 38001470452 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: 'Molino del Traghettino' zipcode: '42023' - country: Italia region: Emilia-Romagna province: 'Reggio Emilia' level: district1 id: 38001470453 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: Traghettino zipcode: '42023' 401: description: Unauthorized content: application/json: schema: type: object example: error: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' properties: error: type: object example: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' tags: - 'Suggest V3 - OLD' /v4/suggest/address: post: summary: Address description: "

Suggestion for address

\n\"Suggest" parameters: - in: header name: Authorization description: '' example: 'Bearer {YOUR_APP_KEY}' schema: type: string - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '' content: application/json: schema: type: object example: data: results: - iso3: ITA id: 38000073665 country: Italia region: Veneto province: Verona city: Verona zipcode: '37136' street: 'Via Roveggia' hn_num: '5' hn_exp: c - iso3: ITA id: 38000860896 country: Italia region: Puglia province: Taranto city: Manduria zipcode: '74024' street: 'Via 5C' hn_num: '5' hn_exp: c - iso3: ITA id: 38000860896 country: Italia region: Puglia province: Taranto city: Manduria district1: 'Torre Colimena' zipcode: '74024' street: 'Via 5C' hn_num: '5' hn_exp: c - iso3: ITA id: 38000074226 country: Italia region: Lazio province: Roma city: Roma zipcode: '00132' street: 'Via Abbateggio' hn_num: '5' hn_exp: c - iso3: ITA id: 38000074227 country: Italia region: Lazio province: Roma city: Roma zipcode: '00132' street: 'Via Acciano' hn_num: '5' hn_exp: c - iso3: ITA id: 38000074228 country: Italia region: Lazio province: Roma city: Roma zipcode: '00132' street: 'Via Acerno' hn_num: '5' hn_exp: c - iso3: ITA id: 38000074229 country: Italia region: Lazio province: Roma city: Roma zipcode: '00132' street: 'Via Acerra' hn_num: '5' hn_exp: c - iso3: ITA id: 38000074230 country: Italia region: Lazio province: Roma city: Roma zipcode: '00132' street: 'Via dell''Acqua Vergine' hn_num: '5' hn_exp: c - iso3: ITA id: 38000074231 country: Italia region: Lazio province: Roma city: Roma zipcode: '00132' street: 'Via Acquacanina' hn_num: '5' hn_exp: c - iso3: ITA id: 38000074232 country: Italia region: Lazio province: Roma city: Roma zipcode: '00132' street: 'Via Acqualagna' hn_num: '5' hn_exp: c system: ret_code: 0 des_ret_code: Ok properties: data: type: object example: results: - iso3: ITA id: 38000073665 country: Italia region: Veneto province: Verona city: Verona zipcode: '37136' street: 'Via Roveggia' hn_num: '5' hn_exp: c - iso3: ITA id: 38000860896 country: Italia region: Puglia province: Taranto city: Manduria zipcode: '74024' street: 'Via 5C' hn_num: '5' hn_exp: c - iso3: ITA id: 38000860896 country: Italia region: Puglia province: Taranto city: Manduria district1: 'Torre Colimena' zipcode: '74024' street: 'Via 5C' hn_num: '5' hn_exp: c - iso3: ITA id: 38000074226 country: Italia region: Lazio province: Roma city: Roma zipcode: '00132' street: 'Via Abbateggio' hn_num: '5' hn_exp: c - iso3: ITA id: 38000074227 country: Italia region: Lazio province: Roma city: Roma zipcode: '00132' street: 'Via Acciano' hn_num: '5' hn_exp: c - iso3: ITA id: 38000074228 country: Italia region: Lazio province: Roma city: Roma zipcode: '00132' street: 'Via Acerno' hn_num: '5' hn_exp: c - iso3: ITA id: 38000074229 country: Italia region: Lazio province: Roma city: Roma zipcode: '00132' street: 'Via Acerra' hn_num: '5' hn_exp: c - iso3: ITA id: 38000074230 country: Italia region: Lazio province: Roma city: Roma zipcode: '00132' street: 'Via dell''Acqua Vergine' hn_num: '5' hn_exp: c - iso3: ITA id: 38000074231 country: Italia region: Lazio province: Roma city: Roma zipcode: '00132' street: 'Via Acquacanina' hn_num: '5' hn_exp: c - iso3: ITA id: 38000074232 country: Italia region: Lazio province: Roma city: Roma zipcode: '00132' street: 'Via Acqualagna' hn_num: '5' hn_exp: c description: '' system: type: object example: ret_code: 0 des_ret_code: Ok 401: description: Unauthorized content: application/json: schema: type: object example: error: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' properties: error: type: object example: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' 422: description: 'Missing restrict_id when restrict_level is present' content: application/json: schema: type: object example: error: code: 422 message: 'The data.restrict id field is required when data.restrict level is present. | Line: 327' details: data.restrict_id: - 'The data.restrict id field is required when data.restrict level is present.' properties: error: type: object example: code: 422 message: 'The data.restrict id field is required when data.restrict level is present. | Line: 327' details: data.restrict_id: - 'The data.restrict id field is required when data.restrict level is present.' tags: - 'Suggest V4' requestBody: required: true content: application/json: schema: type: object properties: data: type: object description: 'The data object.' example: [] properties: query: type: string description: 'Query string.' example: 'Via Roveggia 5c' restrict_id: type: integer description: 'ID of the territorial level.
Used for filtering the research by a certain territorial level.
Can accept multiple values: "38000000001", "72400000001".
It must be combined with data.restrict_level.' example: 38000000001 restrict_level: type: string description: 'Territorial level of restriction.
Used for filtering the research by a certain territorial level.
It must be combined with data.restrict_id.
Allowed values: state, region, province, city, district1.' example: country par: type: object description: 'The parameters object.' example: [] properties: iso3: type: string description: 'Country code (ISO 3166-1 alpha-3).' example: ITA output: type: string description: 'Output format.
Allowed values: NAT, LAT, TRA, INT.' example: null required: - data - par /v4/suggest/country: post: summary: Country description: "

Suggestion for country

\n\"Country" parameters: - in: header name: Authorization description: '' example: 'Bearer {YOUR_APP_KEY}' schema: type: string - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '' content: application/json: schema: type: object example: data: results: - iso3: ITA lngout: '380' country: Italia country_id: 38000000001 system: ret_code: 0 des_ret_code: Ok properties: data: type: object example: results: - iso3: ITA lngout: '380' country: Italia country_id: 38000000001 description: '' system: type: object example: ret_code: 0 des_ret_code: Ok 401: description: Unauthorized content: application/json: schema: type: object example: error: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' properties: error: type: object example: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' 422: description: 'Missing query field' content: application/json: schema: type: object example: error: code: 422 message: 'The data.query field is required. | Line: 327' details: data.query: - 'The data.query field is required.' properties: error: type: object example: code: 422 message: 'The data.query field is required. | Line: 327' details: data.query: - 'The data.query field is required.' tags: - 'Suggest V4' requestBody: required: true content: application/json: schema: type: object properties: data: type: object description: 'The data object.' example: [] properties: query: type: string description: 'Query string.' example: Italia par: type: object description: 'The parameters object.' example: null properties: iso3: type: string description: 'Country code (ISO 3166-1 alpha-3).' example: null max_candidates: type: integer description: 'The maximum number of candidates to return.' example: null required: - data /v4/suggest/state: post: summary: State description: '

Suggestion for state

' parameters: - in: header name: Authorization description: '' example: 'Bearer {YOUR_APP_KEY}' schema: type: string - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '' content: application/json: schema: type: object example: data: results: - iso3: USA lngout: '840' country: 'United States' country_id: 84000000001 state: California state_code: CA state_id: 84000000010 system: ret_code: 0 des_ret_code: Ok properties: data: type: object example: results: - iso3: USA lngout: '840' country: 'United States' country_id: 84000000001 state: California state_code: CA state_id: 84000000010 description: '' system: type: object example: ret_code: 0 des_ret_code: Ok 401: description: Unauthorized content: application/json: schema: type: object example: error: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' properties: error: type: object example: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' 422: description: 'Missing query field' content: application/json: schema: type: object example: error: code: 422 message: 'The data.query field is required. | Line: 327' details: data.query: - 'The data.query field is required.' properties: error: type: object example: code: 422 message: 'The data.query field is required. | Line: 327' details: data.query: - 'The data.query field is required.' tags: - 'Suggest V4' requestBody: required: true content: application/json: schema: type: object properties: data: type: object description: 'The data object.' example: [] properties: query: type: string description: 'Query string.' example: California par: type: object description: 'The parameters object.' example: [] properties: iso3: type: string description: 'Country code (ISO 3166-1 alpha-3).' example: USA max_candidates: type: integer description: 'The maximum number of candidates to return.' example: null required: - data - par /v4/suggest/region: post: summary: Region description: '

Suggestion for region

' parameters: - in: header name: Authorization description: '' example: 'Bearer {YOUR_APP_KEY}' schema: type: string - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '' content: application/json: schema: type: object example: data: results: - iso3: ITA lngout: '380' country: Italia country_id: 38000000001 region: Veneto region_id: 38000000006 system: ret_code: 0 des_ret_code: Ok properties: data: type: object example: results: - iso3: ITA lngout: '380' country: Italia country_id: 38000000001 region: Veneto region_id: 38000000006 description: '' system: type: object example: ret_code: 0 des_ret_code: Ok 401: description: Unauthorized content: application/json: schema: type: object example: error: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' properties: error: type: object example: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' 422: description: 'Missing query field' content: application/json: schema: type: object example: error: code: 422 message: 'The data.query field is required. | Line: 327' details: data.query: - 'The data.query field is required.' properties: error: type: object example: code: 422 message: 'The data.query field is required. | Line: 327' details: data.query: - 'The data.query field is required.' tags: - 'Suggest V4' requestBody: required: true content: application/json: schema: type: object properties: data: type: object description: 'The data object.' example: [] properties: query: type: string description: 'Query string.' example: Veneto par: type: object description: 'The parameters object.' example: [] properties: iso3: type: string description: 'Country code (ISO 3166-1 alpha-3).' example: ITA max_candidates: type: integer description: 'The maximum number of candidates to return.' example: null required: - data - par /v4/suggest/province: post: summary: Province description: '

Suggestion for province

' parameters: - in: header name: Authorization description: '' example: 'Bearer {YOUR_APP_KEY}' schema: type: string - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '' content: application/json: schema: type: object example: data: results: - iso3: ITA lngout: '380' country: Italia country_id: 38000000001 region: Piemonte region_id: 38000000002 province: 'Verbano Cusio Ossola' province_code: VB province_id: 38000000123 system: ret_code: 0 des_ret_code: Ok properties: data: type: object example: results: - iso3: ITA lngout: '380' country: Italia country_id: 38000000001 region: Piemonte region_id: 38000000002 province: 'Verbano Cusio Ossola' province_code: VB province_id: 38000000123 description: '' system: type: object example: ret_code: 0 des_ret_code: Ok 401: description: Unauthorized content: application/json: schema: type: object example: error: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' properties: error: type: object example: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' 422: description: 'Missing query field' content: application/json: schema: type: object example: error: code: 422 message: 'The data.query field is required. | Line: 327' details: data.query: - 'The data.query field is required.' properties: error: type: object example: code: 422 message: 'The data.query field is required. | Line: 327' details: data.query: - 'The data.query field is required.' tags: - 'Suggest V4' requestBody: required: true content: application/json: schema: type: object properties: data: type: object description: 'The data object.' example: [] properties: query: type: string description: 'Query string.' example: Verbano restrict_id: type: integer description: 'ID of the territorial level.
Used for filtering the research by a certain territorial level.' example: null par: type: object description: 'The parameters object.' example: [] properties: iso3: type: string description: 'Country code (ISO 3166-1 alpha-3).' example: ITA max_candidates: type: integer description: 'The maximum number of candidates to return.' example: null required: - data - par /v4/suggest/city: post: summary: City description: "

Suggestion for city

\n\"City" parameters: - in: header name: Authorization description: '' example: 'Bearer {YOUR_APP_KEY}' schema: type: string - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '' content: application/json: schema: type: object example: data: results: - iso3: ITA lngout: '380' country: Italia country_id: 38000000001 region: Piemonte region_id: 38000000002 province: Vercelli province_code: VC province_id: 38000000112 city: Vercelli city_id: 38000001682 zipcode: '13100' - iso3: ITA lngout: '380' country: Italia country_id: 38000000001 region: Piemonte region_id: 38000000002 province: Vercelli province_code: VC province_id: 38000000112 city: 'Borgo Vercelli' city_id: 38000001606 zipcode: '13012' system: ret_code: 0 des_ret_code: Ok properties: data: type: object example: results: - iso3: ITA lngout: '380' country: Italia country_id: 38000000001 region: Piemonte region_id: 38000000002 province: Vercelli province_code: VC province_id: 38000000112 city: Vercelli city_id: 38000001682 zipcode: '13100' - iso3: ITA lngout: '380' country: Italia country_id: 38000000001 region: Piemonte region_id: 38000000002 province: Vercelli province_code: VC province_id: 38000000112 city: 'Borgo Vercelli' city_id: 38000001606 zipcode: '13012' description: '' system: type: object example: ret_code: 0 des_ret_code: Ok 401: description: Unauthorized content: application/json: schema: type: object example: error: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' properties: error: type: object example: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' 422: description: 'Missing query field' content: application/json: schema: type: object example: error: code: 422 message: 'The data.query field is required. | Line: 327' details: data.query: - 'The data.query field is required.' properties: error: type: object example: code: 422 message: 'The data.query field is required. | Line: 327' details: data.query: - 'The data.query field is required.' tags: - 'Suggest V4' requestBody: required: true content: application/json: schema: type: object properties: data: type: object description: 'The data object.' example: [] properties: query: type: string description: 'Query string.' example: Vercelli restrict_id: type: integer description: 'ID of the territorial level.
Used for filtering the research by a certain territorial level.' example: null par: type: object description: 'The parameters object.' example: [] properties: iso3: type: string description: 'Country code (ISO 3166-1 alpha-3).' example: ITA max_candidates: type: integer description: 'The maximum number of candidates to return.' example: null required: - data - par /v4/suggest/district1: post: summary: District1 description: '

Suggestion for district level 1

' parameters: - in: header name: Authorization description: '' example: 'Bearer {YOUR_APP_KEY}' schema: type: string - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '' content: application/json: schema: type: object example: data: results: - iso3: ITA lngout: '380' country: Italia country_id: 38001363482 region: Umbria region_id: 38000000011 province: Perugia province_code: PG province_id: 38000000080 city: Spoleto city_id: 38000000570 district1: Milano district1_id: 38001363482 zipcode: '06049' - iso3: ITA lngout: '380' country: Italia country_id: 38000022330 region: Lombardia region_id: 38000000004 province: Milano province_code: MI province_id: 38000000067 city: Segrate city_id: 38000002479 district1: 'Milano Due' district1_id: 38000022330 zipcode: '20054' - iso3: ITA lngout: '380' country: Italia country_id: 38000009426 region: Emilia-Romagna region_id: 38000000009 province: Ravenna province_code: RA province_id: 38000000088 city: Cervia city_id: 38000005465 district1: 'Milano Marittima' district1_id: 38000009426 zipcode: '48015' - iso3: ITA lngout: '380' country: Italia country_id: 38000019401 region: Lombardia region_id: 38000000004 province: Milano province_code: MI province_id: 38000000067 city: Basiglio city_id: 38000002446 district1: 'Milano Tre' district1_id: 38000019401 zipcode: '20079' - iso3: ITA lngout: '380' country: Italia country_id: 38001129710 region: Lombardia region_id: 38000000004 province: Milano province_code: MI province_id: 38000000067 city: Assago city_id: 38000002471 district1: Milanofiori district1_id: 38001129710 zipcode: '20057' - iso3: ITA lngout: '380' country: Italia country_id: 38001308925 region: Piemonte region_id: 38000000002 province: Torino province_code: TO province_id: 38000000105 city: Torino city_id: 38000001274 district1: 'Barriera di Milano' district1_id: 38001308925 zipcode: '10100' - iso3: ITA lngout: '380' country: Italia country_id: 38001131341 region: Veneto region_id: 38000000006 province: Verona province_code: VR province_id: 38000000115 city: Verona city_id: 38000004730 district1: 'Borgo Milano' district1_id: 38001131341 zipcode: '37100' - iso3: ITA lngout: '380' country: Italia country_id: 38001129711 region: Lombardia region_id: 38000000004 province: Milano province_code: MI province_id: 38000000067 city: Assago city_id: 38000002471 district1: 'Centro Congressi Milanofiori' district1_id: 38001129711 zipcode: '20057' - iso3: ITA lngout: '380' country: Italia country_id: 38000017703 region: 'Trentino-Alto Adige' region_id: 38000000005 province: Trento province_code: TN province_id: 38000000104 city: Sporminore city_id: 38000004751 district1: 'Maso Milano' district1_id: 38000017703 zipcode: '38010' - iso3: ITA lngout: '380' country: Italia country_id: 38000022199 region: Lombardia region_id: 38000000004 province: Lodi province_code: LO province_id: 38000000120 city: 'Tavazzano con Villavesco' city_id: 38000003549 district1: 'Muzza di Milano' district1_id: 38000022199 zipcode: '26838' system: ret_code: 0 des_ret_code: Ok properties: data: type: object example: results: - iso3: ITA lngout: '380' country: Italia country_id: 38001363482 region: Umbria region_id: 38000000011 province: Perugia province_code: PG province_id: 38000000080 city: Spoleto city_id: 38000000570 district1: Milano district1_id: 38001363482 zipcode: '06049' - iso3: ITA lngout: '380' country: Italia country_id: 38000022330 region: Lombardia region_id: 38000000004 province: Milano province_code: MI province_id: 38000000067 city: Segrate city_id: 38000002479 district1: 'Milano Due' district1_id: 38000022330 zipcode: '20054' - iso3: ITA lngout: '380' country: Italia country_id: 38000009426 region: Emilia-Romagna region_id: 38000000009 province: Ravenna province_code: RA province_id: 38000000088 city: Cervia city_id: 38000005465 district1: 'Milano Marittima' district1_id: 38000009426 zipcode: '48015' - iso3: ITA lngout: '380' country: Italia country_id: 38000019401 region: Lombardia region_id: 38000000004 province: Milano province_code: MI province_id: 38000000067 city: Basiglio city_id: 38000002446 district1: 'Milano Tre' district1_id: 38000019401 zipcode: '20079' - iso3: ITA lngout: '380' country: Italia country_id: 38001129710 region: Lombardia region_id: 38000000004 province: Milano province_code: MI province_id: 38000000067 city: Assago city_id: 38000002471 district1: Milanofiori district1_id: 38001129710 zipcode: '20057' - iso3: ITA lngout: '380' country: Italia country_id: 38001308925 region: Piemonte region_id: 38000000002 province: Torino province_code: TO province_id: 38000000105 city: Torino city_id: 38000001274 district1: 'Barriera di Milano' district1_id: 38001308925 zipcode: '10100' - iso3: ITA lngout: '380' country: Italia country_id: 38001131341 region: Veneto region_id: 38000000006 province: Verona province_code: VR province_id: 38000000115 city: Verona city_id: 38000004730 district1: 'Borgo Milano' district1_id: 38001131341 zipcode: '37100' - iso3: ITA lngout: '380' country: Italia country_id: 38001129711 region: Lombardia region_id: 38000000004 province: Milano province_code: MI province_id: 38000000067 city: Assago city_id: 38000002471 district1: 'Centro Congressi Milanofiori' district1_id: 38001129711 zipcode: '20057' - iso3: ITA lngout: '380' country: Italia country_id: 38000017703 region: 'Trentino-Alto Adige' region_id: 38000000005 province: Trento province_code: TN province_id: 38000000104 city: Sporminore city_id: 38000004751 district1: 'Maso Milano' district1_id: 38000017703 zipcode: '38010' - iso3: ITA lngout: '380' country: Italia country_id: 38000022199 region: Lombardia region_id: 38000000004 province: Lodi province_code: LO province_id: 38000000120 city: 'Tavazzano con Villavesco' city_id: 38000003549 district1: 'Muzza di Milano' district1_id: 38000022199 zipcode: '26838' description: '' system: type: object example: ret_code: 0 des_ret_code: Ok 401: description: Unauthorized content: application/json: schema: type: object example: error: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' properties: error: type: object example: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' 422: description: 'Missing query field' content: application/json: schema: type: object example: error: code: 422 message: 'The data.query field is required. | Line: 327' details: data.query: - 'The data.query field is required.' properties: error: type: object example: code: 422 message: 'The data.query field is required. | Line: 327' details: data.query: - 'The data.query field is required.' tags: - 'Suggest V4' requestBody: required: true content: application/json: schema: type: object properties: data: type: object description: 'The data object.' example: [] properties: query: type: string description: 'Query string.' example: Milano restrict_id: type: integer description: 'ID of the territorial level.
Used for filtering the research by a certain territorial level.' example: null par: type: object description: 'The parameters object.' example: [] properties: iso3: type: string description: 'Country code (ISO 3166-1 alpha-3).' example: ITA max_candidates: type: integer description: 'The maximum number of candidates to return.' example: null required: - data - par /v4/suggest/street: post: summary: Street description: "

Suggestion for street

\n\"Suggest" parameters: - in: header name: Authorization description: '' example: 'Bearer {YOUR_APP_KEY}' schema: type: string - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '' content: application/json: schema: type: object example: data: results: - lngout: '380' region: Veneto region_id: 38000000006 province: Verona province_code: VR province_id: 38000000115 city: Verona city_id: 38000004730 zipcode: '37121' street: 'Via Roma' street_id: 38000073652 - lngout: '380' region: Veneto region_id: 38000000006 province: Verona province_code: VR province_id: 38000000115 city: Verona city_id: 38000004730 zipcode: '37134' street: 'Via Romagna' street_id: 38001142331 - lngout: '380' region: Veneto region_id: 38000000006 province: Verona province_code: VR province_id: 38000000115 city: Verona city_id: 38000004730 zipcode: '37139' street: 'Via Beniamino Romagnoli' street_id: 38000073653 system: ret_code: 0 des_ret_code: Ok properties: data: type: object example: results: - lngout: '380' region: Veneto region_id: 38000000006 province: Verona province_code: VR province_id: 38000000115 city: Verona city_id: 38000004730 zipcode: '37121' street: 'Via Roma' street_id: 38000073652 - lngout: '380' region: Veneto region_id: 38000000006 province: Verona province_code: VR province_id: 38000000115 city: Verona city_id: 38000004730 zipcode: '37134' street: 'Via Romagna' street_id: 38001142331 - lngout: '380' region: Veneto region_id: 38000000006 province: Verona province_code: VR province_id: 38000000115 city: Verona city_id: 38000004730 zipcode: '37139' street: 'Via Beniamino Romagnoli' street_id: 38000073653 description: '' system: type: object example: ret_code: 0 des_ret_code: Ok 401: description: Unauthorized content: application/json: schema: type: object example: error: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' properties: error: type: object example: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' 422: description: 'Missing restrict_id field' content: application/json: schema: type: object example: error: code: 422 message: 'The data.restrict id field is required. | Line: 327' details: data.restrict_id: - 'The data.restrict id field is required.' properties: error: type: object example: code: 422 message: 'The data.restrict id field is required. | Line: 327' details: data.restrict_id: - 'The data.restrict id field is required.' tags: - 'Suggest V4' requestBody: required: true content: application/json: schema: type: object properties: data: type: object description: 'The data object.' example: [] properties: query: type: string description: 'Query string.' example: 'Via Roma' restrict_id: type: integer description: 'ID of the city level.
Used for filtering the research by a certain territorial level.' example: 38000004730 par: type: object description: 'The parameters object.' example: [] properties: iso3: type: string description: 'Country code (ISO 3166-1 alpha-3).' example: ITA max_candidates: type: integer description: 'The maximum number of candidates to return.' example: null required: - data - par /v4/suggest/zipcode: post: summary: Zipcode description: '

Suggestion for zipcode

' parameters: - in: header name: Authorization description: '' example: 'Bearer {YOUR_APP_KEY}' schema: type: string - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '' content: application/json: schema: type: object example: data: results: - country: Italia country_id: 38000000001 region: Emilia-Romagna region_id: 38000000009 province: 'Reggio Emilia' province_id: 38000000090 city: 'Cadelbosco di Sopra' city_id: 38000005186 zipcode: '42023' - country: Italia country_id: 38000000001 region: Emilia-Romagna region_id: 38000000009 province: 'Reggio Emilia' province_id: 38000000090 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: Argine district1_id: 38000013982 zipcode: '42023' - country: Italia country_id: 38000000001 region: Emilia-Romagna region_id: 38000000009 province: 'Reggio Emilia' province_id: 38000000090 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: Seta district1_id: 38000013983 zipcode: '42023' - country: Italia country_id: 38000000001 region: Emilia-Romagna region_id: 38000000009 province: 'Reggio Emilia' province_id: 38000000090 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: 'Villa Seta' district1_id: 38000018193 zipcode: '42023' - country: Italia country_id: 38000000001 region: Emilia-Romagna region_id: 38000000009 province: 'Reggio Emilia' province_id: 38000000090 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: Zurco district1_id: 38000022111 zipcode: '42023' - country: Italia country_id: 38000000001 region: Emilia-Romagna region_id: 38000000009 province: 'Reggio Emilia' province_id: 38000000090 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: 'Cadelbosco di Sotto' district1_id: 38000027973 zipcode: '42023' - country: Italia country_id: 38000000001 region: Emilia-Romagna region_id: 38000000009 province: 'Reggio Emilia' province_id: 38000000090 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: 'Santa Vittoria' district1_id: 38000030577 zipcode: '42023' - country: Italia country_id: 38000000001 region: Emilia-Romagna region_id: 38000000009 province: 'Reggio Emilia' province_id: 38000000090 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: 'Argine Vecchio' district1_id: 38001352004 zipcode: '42023' - country: Italia country_id: 38000000001 region: Emilia-Romagna region_id: 38000000009 province: 'Reggio Emilia' province_id: 38000000090 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: Basetti district1_id: 38001352005 zipcode: '42023' - country: Italia country_id: 38000000001 region: Emilia-Romagna region_id: 38000000009 province: 'Reggio Emilia' province_id: 38000000090 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: Cantone district1_id: 38001352006 zipcode: '42023' system: ret_code: 0 des_ret_code: 'Number of Candidates Exceeded, max : 10' properties: data: type: object example: results: - country: Italia country_id: 38000000001 region: Emilia-Romagna region_id: 38000000009 province: 'Reggio Emilia' province_id: 38000000090 city: 'Cadelbosco di Sopra' city_id: 38000005186 zipcode: '42023' - country: Italia country_id: 38000000001 region: Emilia-Romagna region_id: 38000000009 province: 'Reggio Emilia' province_id: 38000000090 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: Argine district1_id: 38000013982 zipcode: '42023' - country: Italia country_id: 38000000001 region: Emilia-Romagna region_id: 38000000009 province: 'Reggio Emilia' province_id: 38000000090 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: Seta district1_id: 38000013983 zipcode: '42023' - country: Italia country_id: 38000000001 region: Emilia-Romagna region_id: 38000000009 province: 'Reggio Emilia' province_id: 38000000090 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: 'Villa Seta' district1_id: 38000018193 zipcode: '42023' - country: Italia country_id: 38000000001 region: Emilia-Romagna region_id: 38000000009 province: 'Reggio Emilia' province_id: 38000000090 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: Zurco district1_id: 38000022111 zipcode: '42023' - country: Italia country_id: 38000000001 region: Emilia-Romagna region_id: 38000000009 province: 'Reggio Emilia' province_id: 38000000090 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: 'Cadelbosco di Sotto' district1_id: 38000027973 zipcode: '42023' - country: Italia country_id: 38000000001 region: Emilia-Romagna region_id: 38000000009 province: 'Reggio Emilia' province_id: 38000000090 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: 'Santa Vittoria' district1_id: 38000030577 zipcode: '42023' - country: Italia country_id: 38000000001 region: Emilia-Romagna region_id: 38000000009 province: 'Reggio Emilia' province_id: 38000000090 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: 'Argine Vecchio' district1_id: 38001352004 zipcode: '42023' - country: Italia country_id: 38000000001 region: Emilia-Romagna region_id: 38000000009 province: 'Reggio Emilia' province_id: 38000000090 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: Basetti district1_id: 38001352005 zipcode: '42023' - country: Italia country_id: 38000000001 region: Emilia-Romagna region_id: 38000000009 province: 'Reggio Emilia' province_id: 38000000090 city: 'Cadelbosco di Sopra' city_id: 38000005186 district1: Cantone district1_id: 38001352006 zipcode: '42023' description: '' system: type: object example: ret_code: 0 des_ret_code: 'Number of Candidates Exceeded, max : 10' 401: description: Unauthorized content: application/json: schema: type: object example: error: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' properties: error: type: object example: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' 422: description: 'Missing query field' content: application/json: schema: type: object example: error: code: 422 message: 'The data.query field is required. | Line: 327' details: data.query: - 'The data.query field is required.' properties: error: type: object example: code: 422 message: 'The data.query field is required. | Line: 327' details: data.query: - 'The data.query field is required.' tags: - 'Suggest V4' requestBody: required: true content: application/json: schema: type: object properties: data: type: object description: 'The data object.' example: [] properties: query: type: string description: 'Query string.' example: '42023' zip_level: type: string description: 'Extraction level. It can be set to:
- L = Candidates at locality level
- S = Candidates at street level - used in GBR / IRL / NLD / JPN
Default: L.' example: L par: type: object description: 'The parameters object.' example: [] properties: iso3: type: string description: 'Country code (ISO 3166-1 alpha-3).' example: ITA max_candidates: type: integer description: 'The maximum number of candidates to return.' example: null required: - data - par /v3/validation: get: summary: 'Validation API V3' description: '

This API will be deprecated starting 1 June 2024. Check the new Validation V4!

' parameters: - in: query name: country_code description: 'Country code (ISO 3166-1 alpha-3 or ISO 3166-1 alpha-2).' example: ITA required: true schema: type: string description: 'Country code (ISO 3166-1 alpha-3 or ISO 3166-1 alpha-2).' example: ITA - in: query name: country description: 'Country. Mandatory if country_code is not valued.' example: null required: false schema: type: string description: 'Country. Mandatory if country_code is not valued.' example: null - in: query name: adm_level1 description: 'Administrative area level 1 (state or region).' example: null required: false schema: type: string description: 'Administrative area level 1 (state or region).' example: null - in: query name: adm_level2 description: 'Administrative area level 2 (province or department or county).' example: null required: false schema: type: string description: 'Administrative area level 2 (province or department or county).' example: null - in: query name: city description: City. example: verona required: false schema: type: string description: City. example: verona - in: query name: locality description: 'Locality or City district or Village.' example: null required: false schema: type: string description: 'Locality or City district or Village.' example: null - in: query name: locality2 description: 'Locality or City district or Village.' example: null required: false schema: type: string description: 'Locality or City district or Village.' example: null - in: query name: addr1 description: 'Address. As an alternative to street_name + house_nr + house_nr_ext.' example: 'via antonio pacinotti 204' required: false schema: type: string description: 'Address. As an alternative to street_name + house_nr + house_nr_ext.' example: 'via antonio pacinotti 204' - in: query name: addr2 description: 'Secondary address.' example: null required: false schema: type: string description: 'Secondary address.' example: null - in: query name: street_name description: 'Street name.' example: null required: false schema: type: string description: 'Street name.' example: null - in: query name: house_nr description: 'House number (including exponents). In addition to street_name as an alternative to addr1.' example: null required: false schema: type: string description: 'House number (including exponents). In addition to street_name as an alternative to addr1.' example: null - in: query name: house_nr_ext description: 'House number extension (additional infos). In addition to street_name and house_nr as an alternative to addr1.' example: null required: false schema: type: string description: 'House number extension (additional infos). In addition to street_name and house_nr as an alternative to addr1.' example: null - in: query name: zipcode description: 'Postal code.' example: null required: false schema: type: string description: 'Postal code.' example: null - in: query name: lng_output description: 'Output Language. By default the input language is preserved, but it can be set to:
- NAT (native)
- TRA (translittered)
- INT (international/english).' example: null required: false schema: type: string description: 'Output Language. By default the input language is preserved, but it can be set to:
- NAT (native)
- TRA (translittered)
- INT (international/english).' example: null - in: query name: fmt_output description: 'Output format. By default the output format is Capitalized, but it can be set to:
- C (capitalized case)
- M (upper case)
- T (upper case without accents).' example: null required: false schema: type: string description: 'Output format. By default the output format is Capitalized, but it can be set to:
- C (capitalized case)
- M (upper case)
- T (upper case without accents).' example: null - in: query name: egon_key_code description: 'Univocal and permanent code identifying a physical location. It can identify a locality or an address.' example: null required: false schema: type: string description: 'Univocal and permanent code identifying a physical location. It can identify a locality or an address.' example: null - in: query name: single_line description: 'Complete address on single line. As an alternative to addr1 or street_name + house_nr + house_nr_ext.' example: null required: false schema: type: string description: 'Complete address on single line. As an alternative to addr1 or street_name + house_nr + house_nr_ext.' example: null - in: query name: po_box description: 'PO Box.' example: null required: false schema: type: string description: 'PO Box.' example: null - in: header name: Authorization description: '' example: 'Bearer {YOUR_APP_KEY}' schema: type: string - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '' content: application/json: schema: type: array items: type: object example: - result: result_fl: '1' output_singleLine: 'Via Antonio Pacinotti,204, Verona, VR, Veneto, 37135, Italia' output_smart: country: Italia adm_level_main: Verona city: Verona addr: 'Via Antonio Pacinotti,204' zipcode: '37135' output_complete: country: Italia state: '' region: Veneto province: Verona city: Verona sub_locality_main: '' sub_locality1: '' sub_locality2: '' sub_locality3: '' postal_town: VERONA zipcode: '37135' addr1: 'Via Antonio Pacinotti,204' addr2: '' street_name: 'Via Antonio Pacinotti' house_number: '204' house_number_ext: '' building: '' subbuilding: '' organization: '' org_department: '' near_by: '' care_of: '' po_box: '' out_lng: '380' egon_codes: egon_city_code: lValue: 38000004730 egon_sbl_code: lValue: 0 egon_str_code: lValue: 38000073526 egon_key_code: lValue: 0 adm_codes: nr9Ele: lValue: 12 areaCode: - code_type: '50137' code_value: VR - code_type: '30000' code_value: L781 - code_type: '30021' code_value: '023091' - code_type: '30022' code_value: '005' - code_type: '30030' code_value: '11700' - code_type: '30050' code_value: '0777000' - code_type: '30060' code_value: '086' - code_type: '30061' code_value: '660999' - code_type: '30070' code_value: ITA - code_type: '30071' code_value: IT - code_type: '30072' code_value: '380' - code_type: '30114' code_value: ITALIA geocoding: geo_level: A41-261 long_lat: '45.40785120 , 10.96922180' - WP9STC: lValue: 0 401: description: Unauthorized content: application/json: schema: type: object example: error: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' properties: error: type: object example: code: 401 message: 'You did not provide an API key. You need to provide your API key in the Authorization header, using Bearer auth (e.g. ''Authorization: Bearer {token}''). See https://account.egon.com/docs for details.' tags: - 'Validation V3 - OLD' /v4/validation/address: post: summary: 'Validation API V4 Address' description: '' parameters: - in: header name: Authorization description: '' example: 'Bearer {YOUR_APP_KEY}' schema: type: string - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '' content: application/json: schema: type: object example: data: address: standard: iso3: ITA country: Italia region: Veneto province: Verona province_code: VR city: Verona zipcode: '37135' street_type: Via street_name: 'Antonio Pacinotti' street: 'Via Antonio Pacinotti' address: 'Via Antonio Pacinotti,4/B' full_address: 'Via Antonio Pacinotti,4/B, Verona, VR, Veneto, 37135, Italia' hn: 4/B postal_town1: VERONA adm_code: - iso3: ITA type: '50137' value: VR - iso3: ITA type: '30030' value: '11700' - iso3: ITA type: '30000' value: L781 - iso3: ITA type: '30021' value: '023091' - iso3: ITA type: '30060' value: '086' - iso3: ITA type: '30061' value: '660999' - iso3: ITA type: '30050' value: '0777000' - iso3: ITA type: '30071' value: IT - iso3: ITA type: '30070' value: ITA - iso3: ITA type: '30072' value: '380' - iso3: ITA type: '30114' value: ITALIA - iso3: ITA type: '30022' value: '005' egon_code: city: 38000004730 street: 38000073526 hn: 380100008326045 smart: country: Italia administrative_level: Verona city: Verona address: 'Via Antonio Pacinotti,4/B' zipcode: '37135' geo: lat_long: '45.40616800, 10.97379600' geo_level: A41-111 census_code: '0230910000922' postal: row4: 'VIA ANTONIO PACINOTTI 4/B' row5: '37135 VERONA VR' quality: address: locality: flag: '0' code: 0 description: Ok street: flag: '1' code: 801 description: 'Candidato strada con parole in meno' hn: flag: '0' code: 0 description: Ok system: ret_code: 0 des_ret_code: Ok properties: data: type: object example: address: standard: iso3: ITA country: Italia region: Veneto province: Verona province_code: VR city: Verona zipcode: '37135' street_type: Via street_name: 'Antonio Pacinotti' street: 'Via Antonio Pacinotti' address: 'Via Antonio Pacinotti,4/B' full_address: 'Via Antonio Pacinotti,4/B, Verona, VR, Veneto, 37135, Italia' hn: 4/B postal_town1: VERONA adm_code: - iso3: ITA type: '50137' value: VR - iso3: ITA type: '30030' value: '11700' - iso3: ITA type: '30000' value: L781 - iso3: ITA type: '30021' value: '023091' - iso3: ITA type: '30060' value: '086' - iso3: ITA type: '30061' value: '660999' - iso3: ITA type: '30050' value: '0777000' - iso3: ITA type: '30071' value: IT - iso3: ITA type: '30070' value: ITA - iso3: ITA type: '30072' value: '380' - iso3: ITA type: '30114' value: ITALIA - iso3: ITA type: '30022' value: '005' egon_code: city: 38000004730 street: 38000073526 hn: 380100008326045 smart: country: Italia administrative_level: Verona city: Verona address: 'Via Antonio Pacinotti,4/B' zipcode: '37135' geo: lat_long: '45.40616800, 10.97379600' geo_level: A41-111 census_code: '0230910000922' postal: row4: 'VIA ANTONIO PACINOTTI 4/B' row5: '37135 VERONA VR' description: '' quality: type: object example: address: locality: flag: '0' code: 0 description: Ok street: flag: '1' code: 801 description: 'Candidato strada con parole in meno' hn: flag: '0' code: 0 description: Ok description: 'Quality indicators' system: type: object example: ret_code: 0 des_ret_code: Ok description: 'System error' tags: - 'Validation V4' requestBody: required: true content: application/json: schema: type: object properties: par: type: object description: '' example: [] properties: iso3: type: string description: 'Country code (ISO 3166-1 alpha-3).' example: ITA fmtout: type: string description: 'Output format:
- "C" for Capitalized
- "M" for Upper case
- "T" for Upper case without accents' example: null lngout: type: string description: 'Output language:
- "NAT" for native output language
- "TRA" for transliterated output language
- "INT" for international/english output language
- "empty" for keeping the input language' example: null tpxout: type: string description: 'Output description:
- "LAT" for latinized (without accents)
' example: null geo: type: string description: 'Output geocoding (Default: N):
- "S" geocoding on
- "N" geocoding off (default)' example: S data: type: object description: '' example: address: [] properties: address: type: object description: '' example: [] properties: egoncode_place: type: integer description: 'Egon code place' example: null egoncode_hn: type: integer description: 'Egon code house number' example: null country: type: string description: 'Country description' example: null state: type: string description: 'State description' example: null region: type: string description: 'Region description' example: null province: type: string description: 'Province description' example: null city: type: string description: 'City description' example: Verona district1: type: string description: 'District1 description' example: null district2: type: string description: 'District2 description' example: null district3: type: string description: 'District3 descriptio.' example: null zipcode: type: string description: 'Zipcode description' example: null street_type: type: string description: 'Town planning name (contains the type: Street, Square, Avenue, etc.)' example: null street: type: string description: 'Street description' example: 'Via Pacinotti 4b' address: type: string description: 'Full address' example: null hn: type: string description: 'House number' example: null building: type: string description: Building example: null sub_building: type: string description: 'Sub Building' example: null organization: type: string description: Organization example: null street_type_str2: type: string description: 'Town planning name 2 (contains the type: Street, Square, Avenue, etc.)' example: null street_2: type: string description: 'Street 2 description' example: null hn_2: type: string description: 'House number 2' example: null required: - par - data /v4/validation/emails: post: summary: 'Validation API V4 Emails' description: '

Email normalization. Maximum of 5 emails in input.

' parameters: - in: header name: Authorization description: '' example: 'Bearer {YOUR_APP_KEY}' schema: type: string - in: header name: Content-Type description: '' example: application/json schema: type: string - in: header name: Accept description: '' example: application/json schema: type: string responses: 200: description: '' content: application/json: schema: type: object example: data: emails: - email: mario.rossi@gmail.com quality: emails: - email1: flag: '1' code: 991 system: ret_code: 0 des_ret_code: Ok properties: data: type: object example: emails: - email: mario.rossi@gmail.com quality: type: object example: emails: - email1: flag: '1' code: 991 system: type: object example: ret_code: 0 des_ret_code: Ok tags: - 'Validation V4' requestBody: required: true content: application/json: schema: type: object properties: par: type: object description: '' example: [] properties: iso3: type: string description: 'Country code (ISO 3166-1 alpha-3).' example: ITA data: type: object description: '' example: [] properties: emails: type: array description: '' example: - email: mario.rossi@gmail.com items: type: object properties: email: type: required description: 'string Email to be normalized.' example: null required: - par - data tags: - name: 'Suggest V3 - OLD' description: '' - name: 'Suggest V4' description: '' - name: 'Validation V3 - OLD' description: '' - name: 'Validation V4' description: '' components: securitySchemes: default: type: http scheme: bearer description: '' security: - default: []