{"openapi":"3.2.0","info":{"title":"AddressPerfect International Zipcodes API","description":"Global ZIP Code & City Autocomplete API. It offers real-time search and retrieval of postal codes and cities across all countries, ensuring fast, accurate, and error-free data entry. With powerful prefix-based lookups and full-text search, the API simplifies address capture, improves data quality, and enhances user experience for international applications.","version":"1.0.0"},"servers":[{"url":"https://niavn.jojapi.net"}],"security":[{"ApiKeyAuth":[]}],"paths":{"/autocomplete":{"get":{"operationId":"get_autocomplete","summary":"Autocomplete Int","description":"Provides a full text search functionality over zipcodes and cities of all countries. Returns the matches\nin the order of relevance.\n\nReturn value is a list of `ZIPCityResponse` objects with the relevant fields filled in.","parameters":[{"name":"query","in":"query","description":"Search String","required":false,"schema":{"type":"string","title":"query","example":"1200 Geneve"}}]}},"/getcitylist":{"get":{"operationId":"get_getcitylist","summary":"Getortlist Int","description":"Get a list of Cities for the Country (country = [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)\n) and, optionally, a zip code or a city prefix. Country can be null, in which case all countries are searched\n\nIf no zip code is provided, city must be at least 2 characters long\n\nIf you provide a city prefix, the result will be a list of cities starting with the prefix.\nZipcode must be the zipcode (as provided by /getziplist). Partial zip codes are not matched.","parameters":[{"name":"zip","in":"query","required":false,"schema":{"type":"string","title":"zip","example":"81"}},{"name":"city","in":"query","required":false,"schema":{"type":"string","title":"city","example":"W"}},{"name":"country","in":"query","required":false,"schema":{"type":"string","title":"country","example":"CH"}}]}},"/getziplist":{"get":{"operationId":"get_getziplist","summary":"Getplzlist Int","description":"Get a list of Zipcodes for the Country (country = [ISO 3166-1 alpha-2 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)\n) and, optionally, a city or a zip code prefix. Country can be null, in which case all countries are searched.\n\nIf no city is provided, zipcode must be at least 2 characters long\n\nIf you provide a zip code prefix, the result will be a list of zip codes starting with the prefix.\nCity must be the whole city (as provided by /getcitylist). Partial city names are not matched.","parameters":[{"name":"zip","in":"query","description":"Zipcode prefix or full zipcode","required":false,"schema":{"type":"string","title":"zip","example":"103"}},{"name":"city","in":"query","description":"City Prefix or full City name","required":false,"schema":{"type":"string","title":"city","example":"Berlin"}},{"name":"country","in":"query","description":"ISO 3166-1 alpha-2 country code","required":false,"schema":{"type":"string","title":"country","example":"DE"}}]}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-JoJAPI-Key","description":"Your JoJ API key."}}}}