Byteplant Logo

World ZIP API

Locality Details for 240 Countries

Complete, Accurate, Always Up-to-Date

Postal Code/ZIP Verification for 240 countries world-wide.

Global Postal Code/ZIP API for 240 Countries

Our API provides the most complete and accurate postal code/ZIP data for 240 countries - ideal for any organisation with a global footprint.

Use Cases

Our World Postal Code/ZIP API offers flexible tools to address a wide range of real-world scenarios and powers many different use cases.

Trusted by Enterprises and Governments Since 2003 for Data Accuracy in 240 Countries

You need an account to test our services.
Please log in or register for a free trial.

Client Reviews

World ZIP API

The World ZIP API returns suggestions matching the ZIP / Postal Code provided as input query.

GET POST
https://api.address-validator.net/api/search

Input Parameters

Parameter Description Type Optional
Query Search text string No
CountryCode Two-letter ISO 3166-1 country code, 'XX' for international string No
MatchLevel Use "locality" for the World ZIP API string No
Locale Output language for countries with multiple postal languages. Default=[Local Language], Values=[IETF language tag] string Yes
APIKey Your API key string No
MaxResults Maximum number of results. Default=5, Values=[1-20] int Yes
Timeout Timeout in seconds. Default=10, Values=[5-300] int Yes

API Result

        {
          "status": "UNVERIFIED|DELAYED|RATE_LIMIT_EXCEEDED|API_KEY_INVALID_OR_DEPLETED|RESTRICTED|INTERNAL_ERROR",
          "ratelimit_remain": "100",  // Number of API requests remaining before the API rate limit is reached
          "ratelimit_seconds": "137", // Number of seconds remaining in the current rate limit interval
          "results": [
              "id": "id to retrieve details for this address using the World ZIP Retrieval API",
              "description": "address label"
          ]
        }
      

World ZIP Retrieval API

The World ZIP Retrieval API returns detailed information for an address id provided as suggestion from the World ZIP API.

GET POST
https://api.address-validator.net/api/fetch

Input Parameters

Parameter Description Type Optional
ID Address ID as provided from the World ZIP API string No
APIKey Your API key string No
Geocoding Enable Geocoding. Default=false, Values=[true|false] string Yes
Timeout Timeout in seconds. Default=10, Values=[5-300] int Yes

API Result

        {
          "status": "UNVERIFIED|DELAYED|RATE_LIMIT_EXCEEDED|API_KEY_INVALID_OR_DEPLETED|RESTRICTED|INTERNAL_ERROR", 
          "formattedaddress": "Full address in standardized format",
          "postalcode": "ZIP/Postal code",
          "city": "City in standardized format",
          "district": "District in standardized format",
          "county": "County in standardized format",
          "state": "State / Province in standardized format",
          "country": "Country",
          "ratelimit_remain": "100", // Number of API requests remaining before the API rate limit is reached
          "ratelimit_seconds": "137" // Number of seconds remaining in the current rate limit interval
        }
      
World ZIP API Credits per request
Search API 0.1 (Level: Locality)
Fetch API 0.2

 


Available Countries: 240+ Countries, as seen in our Coverage Map

Unlimited Plans / Flat Rates Available

We offer unlimited plans for these countries:

  • Germany, Austria, Switzerland
  • France
  • Denmark, Finland, Norway, Faroe Islands, Iceland
  • Lithuania, Estonia, Latvia
  • Belgium, Netherlands, Luxembourg
  • Czech Republic, Slovakia, Poland, Slovenia
  • Portugal
  • Australia

If you are processing more than 1 million addresses per year, please contact our sales team.

Seamless Integration with Your Existing Ecosystem

60+ Integrations ensure all your systems and processes work in perfect sync, driving performance and compliance.

View all Integrations

How to use the World Postal Code/ZIP API

Integrating our World Postal Code/ZIP API into your systems and processes is quick and easy. The API is very flexible - you can for example customize it to only suggest results from certain countries.

Free Trial!World Postal Code/ZIP API

Still not sure it's for you? Try our World Postal Code/ZIP API and see for yourself. It's easy to use - get started now with a free API key.

Frequently Asked Questions

Which countries does the World ZIP API cover?

Our World ZIP API covers 240+ countries world-wide.

How does the Global Postal Code/ZIP API work?

The World ZIP API includes a ZIP / Postal Code lookup and provides Locality, State and Country details for 240+ countries.

Is the ZIP API easy to integrate with my existing systems?

World ZIP API can be integrated via the Online API or Zapier. Please see the complete list of integrations here

What types of data does the Postal Code/ZIP API return?

The World ZIP API returns address details like Locality, State and Country based on the ZIP / Postal Code data input.

How fast is the API response time?

API requests will be typically answered within 125ms.

Which availability do you guarantee for the World ZIP API?

Our APIs are hosted at three different locations in Europe. We guarantee an availability of 99.9% - please see the API server status page for real-time availability information.

Data Protection/GDPR: Is the World ZIP API GDPR compliant?

The World ZIP API is a service operated by Byteplant, a company located in Germany and operating according to EU General Data Protection Regulation (GDPR) standards and the German Federal Data Protection Act (BDSG) - one of the strictest data protection and privacy legislations in the world(see Bundesdatenschutzgesetz for details). We do not process or store addresses for any purpose other than validation. We do not share any client data with any third party at any time. We retain personal data processed on behalf of our clients for as long as needed to provide services to our clients. All data from API requests will be automatically deleted within 14 days after the data has been made available to us.

More FAQs ...