The Geographical Codes API is the ultimate solution for accessing accurate and up-to-date ISO codes for countries and their subdivisions. Designed to streamline your application's data management, the API allows users, developers, businesses and researchers to effortlessly retrieve ISO country and subdivision codes, simplifying geographic data management and enabling better global understanding.
The Geographical Codes API has been created to meet the diverse needs of different industries, from e-commerce and logistics to finance and academic research. It serves as a fundamental tool for accessing essential information that underpins countless location-based services, legal requirements and data analysis applications around the world.
At the core of this API is a comprehensive and regularly updated database of ISO 3166-1 and ISO 3166-2 codes, which maintains data accuracy and currency to ensure you always have access to the latest information. These standardized codes are essential for identifying countries and their subdivisions in a consistent and universally recognized format, facilitating the integration and exchange of data between different platforms and systems.
The intuitive and user-friendly design of the API ensures seamless integration into your applications. With clear and well-documented endpoints, you can effortlessly retrieve ISO country codes, saving valuable development time and resources. Whether you are an experienced developer or just starting out, implementing the API into your project is a smooth process.
The Geographical Codes API is highly available and reliable, allowing you to access data with fast and accurate response time. Our state-of-the-art infrastructure ensures that your application can reliably retrieve ISO codes at any time, ensuring a smooth user experience for your customers and users.
In summary, the Geographical Codes API is a versatile and indispensable tool for accessing ISO country and subdivision codes. It enables developers and companies to streamline data management, optimize global operations and meet legal requirements. With its up-to-date database, ease of integration and robust security, the API lays the foundation for enhanced location-based services, global research and effective data analysis. Harness the power of ISO codes with the Geographical Codes API and take your application to new heights in the interconnected world.
It will receive parameters and provide you with a JSON.
Address validation: E-commerce platforms and logistics companies can use the API to validate and standardize customer addresses, ensuring accurate and efficient delivery of goods worldwide.
International shipping: Companies can leverage ISO codes to facilitate international shipments by automatically completing customs documents and complying with country-specific regulations.
Multilingual Web sites: Web sites serving a global audience can display country and subdivision names in different languages based on ISO codes, improving user experience and localization.
Financial transactions: Financial institutions can use ISO codes to identify countries and subdivisions to process cross-border transactions, complying with international banking regulations.
Academic research: Researchers and academics can use the API to organize and analyze data for global studies, regional comparisons and international collaborations.
Basic Plan: 600 API Calls. 3 requests per second.
Pro Plan: 1,500 API Calls. 3 requests per second.
Pro Plus Plan: 5,500 API Calls. 3 requests per second.
To use this endpoint you must indicate in the parameter the name of a country.
Get ISO codes by country - Endpoint Features
| Object | Description |
|---|---|
name |
[Required] |
[{"name":"Germany","alpha2Code":"DE","alpha3Code":"DEU","numericCode":"276"}]
curl --location --request GET 'https://zylalabs.com/api/2338/geographical+codes+api/2251/get+iso+codes+by+country?name=Germany' --header 'Authorization: Bearer YOUR_API_KEY'
To use this endpoint you must indicate in the parameter an ISO 2 code.
Get country by ISO two code - Endpoint Features
| Object | Description |
|---|---|
alpha2Code |
[Required] |
[{"name":"United States of America","alpha2Code":"US","alpha3Code":"USA","numericCode":"840"}]
curl --location --request GET 'https://zylalabs.com/api/2338/geographical+codes+api/2252/get+country+by+iso+two+code?alpha2Code=US' --header 'Authorization: Bearer YOUR_API_KEY'
To use this endpoint you must indicate in the parameter an ISO three code.
Get country by ISO three code - Endpoint Features
| Object | Description |
|---|---|
alpha3Code |
[Required] |
[{"name":"United States of America","alpha2Code":"US","alpha3Code":"USA","numericCode":"840"}]
curl --location --request GET 'https://zylalabs.com/api/2338/geographical+codes+api/2253/get+country+by+iso+three+code?alpha3Code=USA' --header 'Authorization: Bearer YOUR_API_KEY'
To use this endpoint you must indicate in the parameter an ISO 2 code.
Get all country subdivisions - Endpoint Features
| Object | Description |
|---|---|
iso2code |
[Required] |
[{"name":"Baden-Württemberg","code":"DE-BW","category":"Land"},{"name":"Bayern","code":"DE-BY","category":"Land"},{"name":"Berlin","code":"DE-BE","category":"Land"},{"name":"Brandenburg","code":"DE-BB","category":"Land"},{"name":"Bremen","code":"DE-HB","category":"Land"},{"name":"Hamburg","code":"DE-HH","category":"Land"},{"name":"Hessen","code":"DE-HE","category":"Land"},{"name":"Mecklenburg-Vorpommern","code":"DE-MV","category":"Land"},{"name":"Niedersachsen","code":"DE-NI","category":"Land"},{"name":"Nordrhein-Westfalen","code":"DE-NW","category":"Land"},{"name":"Rheinland-Pfalz","code":"DE-RP","category":"Land"},{"name":"Saarland","code":"DE-SL","category":"Land"},{"name":"Sachsen","code":"DE-SN","category":"Land"},{"name":"Sachsen-Anhalt","code":"DE-ST","category":"Land"},{"name":"Schleswig-Holstein","code":"DE-SH","category":"Land"},{"name":"Thüringen","code":"DE-TH","category":"Land"}]
curl --location --request GET 'https://zylalabs.com/api/2338/geographical+codes+api/2254/get+all+country+subdivisions?iso2code=DE' --header 'Authorization: Bearer YOUR_API_KEY'
| Header | Description |
|---|---|
Authorization
|
[Required] Should be Bearer access_key. See "Your API Access Key" above when you are subscribed. |
No long-term commitment. Upgrade, downgrade, or cancel anytime. Free Trial includes up to 50 requests.
There are different plans suits everyone including a free plan for small amount of requests per day, but it’s rate is limit to prevent abuse of the service.
Zyla provides a wide range of integration methods for almost all programming languages. You can use these codes to integrate with your project as you need.
The Geographical Codes API is a tool to easily access ISO codes for countries and subdivisions.
Users must enter a country name to obtain ISO Codes.
Each endpoint returns JSON data containing ISO codes for countries and subdivisions. For example, the "Get ISO codes by country" endpoint returns the country name along with its alpha-2, alpha-3, and numeric codes.
The key fields in the response data include "name" (country or subdivision name), "alpha2Code" (ISO 3166-1 alpha-2 code), "alpha3Code" (ISO 3166-1 alpha-3 code), and "numericCode" (ISO numeric code).
Each endpoint provides specific information: country names and their ISO codes, subdivisions by country, and the ability to retrieve data using different ISO code formats (2 or 3).
The response data is organized as an array of JSON objects. Each object contains fields like "name," "alpha2Code," "alpha3Code," and "numericCode," allowing for easy parsing and integration.
The data is sourced from the ISO 3166 standard, which is maintained by the International Organization for Standardization. This ensures that the codes are accurate and up-to-date.
Users can customize their requests by specifying parameters such as country names or ISO codes when calling the respective endpoints, allowing for targeted data retrieval.
Typical use cases include address validation for e-commerce, international shipping documentation, multilingual website localization, and academic research data organization.
Users can utilize the returned data by integrating it into applications for tasks like validating addresses, processing transactions, or displaying country information in user interfaces, enhancing functionality and user experience.
Please have a look at our Refund Policy: https://zylalabs.com/terms#refund
To obtain your API key, you first need to sign in to your account and subscribe to the API you want to use. Once subscribed, go to your Profile, open the Subscription section, and select the specific API. Your API key will be available there and can be used to authenticate your requests.
You can’t switch APIs during the free trial. If you subscribe to a different API, your trial will end and the new subscription will start as a paid plan.
If you don’t cancel before the 7th day, your free trial will end automatically and your subscription will switch to a paid plan under the same plan you originally subscribed to, meaning you will be charged and gain access to the API calls included in that plan.
The free trial ends when you reach 50 API requests or after 7 days, whichever comes first.
No, the free trial is available only once, so we recommend using it on the API that interests you the most. Most of our APIs offer a free trial, but some may not include this option.
Yes, we offer a 7-day free trial that allows you to make up to 50 API calls at no cost, so you can test our APIs without any commitment.
Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.
Service Level:
100%
Response Time:
5,227ms
Service Level:
100%
Response Time:
172ms
Service Level:
100%
Response Time:
570ms
Service Level:
100%
Response Time:
1,779ms
Service Level:
100%
Response Time:
39ms
Service Level:
100%
Response Time:
468ms
Service Level:
100%
Response Time:
140ms
Service Level:
100%
Response Time:
97ms
Service Level:
100%
Response Time:
670ms
Service Level:
100%
Response Time:
3,656ms
Service Level:
100%
Response Time:
329ms
Service Level:
100%
Response Time:
162ms
Service Level:
100%
Response Time:
201ms
Service Level:
100%
Response Time:
1,026ms
Service Level:
100%
Response Time:
921ms
Service Level:
100%
Response Time:
7,076ms
Service Level:
100%
Response Time:
398ms
Service Level:
100%
Response Time:
1,094ms
Service Level:
100%
Response Time:
227ms
Service Level:
100%
Response Time:
875ms