The Country Details API is a robust tool that provides detailed information on countries around the world. It serves as a central repository of essential country-related data points, including country data.
The API offers comprehensive coverage of countries around the world, providing users with access to accurate and up-to-date information. Each country entry includes key details such as its official name, ISO 3166-1 (alpha-2 and alpha-3) codes, flag emoji representation, international calling code and administrative subdivisions, if applicable.
For telecommunications purposes, the API includes the international prefixes associated with each country. This data is essential for applications that require users to enter or verify phone numbers across different international standards.
Many countries have administrative subdivisions such as states, provinces or regions. The API provides detailed information about these subdivisions, including unique codes and names. This hierarchical data allows developers to localize applications, tailor content based on regional preferences, and meet the specific regulatory requirements of different jurisdictions.
In summary, the Country Details API is a valuable resource for accessing comprehensive, standardized information about countries around the world. Whether used to improve user experience, optimize operational workflows or support strategic decision making, the API provides essential country-related data needed to create innovative and scalable applications in a variety of domains.
It will receive a parameter and provide you with a JSON.
Geolocation Services: Utilize the API to determine the country based on IP addresses or GPS coordinates, enhancing location-based services in applications.
Address Auto-Completion: Integrate country data to assist users in filling out address forms by providing auto-completion suggestions based on country codes or names.
Phone Number Validation: Validate and format international phone numbers using the API's international calling codes and prefixes, ensuring accuracy in telecommunications applications.
Regional Content Customization: Tailor content and user experiences based on the user's country or region, leveraging the API's subdivision data (states, provinces) for localization.
Compliance and Regulatory Requirements: Access country-specific information such as ISO codes and administrative divisions to comply with regulatory requirements across different jurisdictions.
Besides the number of API calls per month, there are no other limitations.
To use this endpoint you must indicate the country code of a country in the parameter
Country Information - Endpoint Features
| Object | Description |
|---|---|
country |
[Required] |
{"data":{"value":"United Kingdom","key":"GB","cca3":"GBR","emoji":"🇬🇧","calling_code":[44],"subdivision":[{"code":"GB-ABC","name":"Armagh, Banbridge and Craigavon"},{"code":"GB-ABD","name":"Aberdeenshire"},{"code":"GB-ABE","name":"Aberdeen City"},{"code":"GB-AGB","name":"Argyll and Bute"},{"code":"GB-AGY","name":"Isle of Anglesey; Sir Ynys Môn"},{"code":"GB-AND","name":"Ards and North Down"},{"code":"GB-ANN","name":"Antrim and Newtownabbey"},{"code":"GB-ANS","name":"Angus"},{"code":"GB-BAS","name":"Bath and North East Somerset"},{"code":"GB-BBD","name":"Blackburn with Darwen"},{"code":"GB-BDF","name":"Bedford"},{"code":"GB-BDG","name":"Barking and Dagenham"},{"code":"GB-BEN","name":"Brent"},{"code":"GB-BEX","name":"Bexley"},{"code":"GB-BFS","name":"Belfast"},{"code":"GB-BGE","name":"Bridgend; Pen-y-bont ar Ogwr"},{"code":"GB-BGW","name":"Blaenau Gwent"},{"code":"GB-BIR","name":"Birmingham"},{"code":"GB-BKM","name":"Buckinghamshire"},{"code":"GB-BMH","name":"Bournemouth"},{"code":"GB-BNE","name":"Barnet"},{"code":"GB-BNH","name":"Brighton and Hove"},{"code":"GB-BNS","name":"Barnsley"},{"code":"GB-BOL","name":"Bolton"},{"code":"GB-BPL","name":"Blackpool"},{"code":"GB-BRC","name":"Bracknell Forest"},{"code":"GB-BRD","name":"Bradford"},{"code":"GB-BRY","name":"Bromley"},{"code":"GB-BST","name":"Bristol, City of"},{"code":"GB-BUR","name":"Bury"},{"code":"GB-CAM","name":"Cambridgeshire"},{"code":"GB-CAY","name":"Caerphilly; Caerffili"},{"code":"GB-CBF","name":"Central Bedfordshire"},{"code":"GB-CCG","name":"Causeway Coast and Glens"},{"code":"GB-CGN","name":"Ceredigion; Sir Ceredigion"},{"code":"GB-CHE","name":"Cheshire East"},{"code":"GB-CHW","name":"Cheshire West and Chester"},{"code":"GB-CLD","name":"Calderdale"},{"code":"GB-CLK","name":"Clackmannanshire"},{"code":"GB-CMA","name":"Cumbria"},{"code":"GB-CMD","name":"Camden"},{"code":"GB-CMN","name":"Carmarthenshire; Sir Gaerfyrddin"},{"code":"GB-CON","name":"Cornwall"},{"code":"GB-COV","name":"Coventry"},{"code":"GB-CRF","name":"Cardiff; Caerdydd"},{"code":"GB-CRY","name":"Croydon"},{"code":"GB-CWY","name":"Conwy"},{"code":"GB-DAL","name":"Darlington"},{"code":"GB-DBY","name":"Derbyshire"},{"code":"GB-DEN","name":"Denbighshire; Sir Ddinbych"},{"code":"GB-DER","name":"Derby"},{"code":"GB-DEV","name":"Devon"},{"code":"GB-DGY","name":"Dumfries and Galloway"},{"code":"GB-DNC","name":"Doncaster"},{"code":"GB-DND","name":"Dundee City"},{"code":"GB-DOR","name":"Dorset"},{"code":"GB-DRS","name":"Derry and Strabane"},{"code":"GB-DUD","name":"Dudley"},{"code":"GB-DUR","name":"Durham County"},{"code":"GB-EAL","name":"Ealing"},{"code":"GB-EAW","name":"England and Wales"},{"code":"GB-EAY","name":"East Ayrshire"},{"code":"GB-EDH","name":"Edinburgh, City of"},{"code":"GB-EDU","name":"East Dunbartonshire"},{"code":"GB-ELN","name":"East Lothian"},{"code":"GB-ELS","name":"Eilean Siar"},{"code":"GB-ENF","name":"Enfield"},{"code":"GB-ENG","name":"England"},{"code":"GB-ERW","name":"East Renfrewshire"},{"code":"GB-ERY","name":"East Riding of Yorkshire"},{"code":"GB-ESS","name":"Essex"},{"code":"GB-ESX","name":"East Sussex"},{"code":"GB-FAL","name":"Falkirk"},{"code":"GB-FIF","name":"Fife"},{"code":"GB-FLN","name":"Flintshire; Sir y Fflint"},{"code":"GB-FMO","name":"Fermanagh and Omagh"},{"code":"GB-GAT","name":"Gateshead"},{"code":"GB-GBN","name":"Great Britain"},{"code":"GB-GLG","name":"Glasgow City"},{"code":"GB-GLS","name":"Gloucestershire"},{"code":"GB-GRE","name":"Greenwich"},{"code":"GB-GWN","name":"Gwynedd"},{"code":"GB-HAL","name":"Halton"},{"code":"GB-HAM","name":"Hampshire"},{"code":"GB-HAV","name":"Havering"},{"code":"GB-HCK","name":"Hackney"},{"code":"GB-HEF","name":"Herefordshire"},{"code":"GB-HIL","name":"Hillingdon"},{"code":"GB-HLD","name":"Highland"},{"code":"GB-HMF","name":"Hammersmith and Fulham"},{"code":"GB-HNS","name":"Hounslow"},{"code":"GB-HPL","name":"Hartlepool"},{"code":"GB-HRT","name":"Hertfordshire"},{"code":"GB-HRW","name":"Harrow"},{"code":"GB-HRY","name":"Haringey"},{"code":"GB-IOS","name":"Isles of Scilly"},{"code":"GB-IOW","name":"Isle of Wight"},{"code":"GB-ISL","name":"Islington"},{"code":"GB-IVC","name":"Inverclyde"},{"code":"GB-KEC","name":"Kensington and Chelsea"},{"code":"GB-KEN","name":"Kent"},{"code":"GB-KHL","name":"Kingston upon Hull"},{"code":"GB-KIR","name":"Kirklees"},{"code":"GB-KTT","name":"Kingston upon Thames"},{"code":"GB-KWL","name":"Knowsley"},{"code":"GB-LAN","name":"Lancashire"},{"code":"GB-LBC","name":"Lisburn and Castlereagh"},{"code":"GB-LBH","name":"Lambeth"},{"code":"GB-LCE","name":"Leicester"},{"code":"GB-LDS","name":"Leeds"},{"code":"GB-LEC","name":"Leicestershire"},{"code":"GB-LEW","name":"Lewisham"},{"code":"GB-LIN","name":"Lincolnshire"},{"code":"GB-LIV","name":"Liverpool"},{"code":"GB-LND","name":"London, City of"},{"code":"GB-LUT","name":"Luton"},{"code":"GB-MAN","name":"Manchester"},{"code":"GB-MDB","name":"Middlesbrough"},{"code":"GB-MDW","name":"Medway"},{"code":"GB-MEA","name":"Mid and East Antrim"},{"code":"GB-MIK","name":"Milton Keynes"},{"code":"GB-MLN","name":"Midlothian"},{"code":"GB-MON","name":"Monmouthshire; Sir Fynwy"},{"code":"GB-MRT","name":"Merton"},{"code":"GB-MRY","name":"Moray"},{"code":"GB-MTY","name":"Merthyr Tydfil; Merthyr Tudful"},{"code":"GB-MUL","name":"Mid Ulster"},{"code":"GB-NAY","name":"North Ayrshire"},{"code":"GB-NBL","name":"Northumberland"},{"code":"GB-NEL","name":"North East Lincolnshire"},{"code":"GB-NET","name":"Newcastle upon Tyne"},{"code":"GB-NFK","name":"Norfolk"},{"code":"GB-NGM","name":"Nottingham"},{"code":"GB-NIR","name":"Northern Ireland"},{"code":"GB-NLK","name":"North Lanarkshire"},{"code":"GB-NLN","name":"North Lincolnshire"},{"code":"GB-NMD","name":"Newry, Mourne and Down"},{"code":"GB-NSM","name":"North Somerset"},{"code":"GB-NTH","name":"Northamptonshire"},{"code":"GB-NTL","name":"Neath Port Talbot; Castell-nedd Port Talbot"},{"code":"GB-NTT","name":"Nottinghamshire"},{"code":"GB-NTY","name":"North Tyneside"},{"code":"GB-NWM","name":"Newham"},{"code":"GB-NWP","name":"Newport; Casnewydd"},{"code":"GB-NYK","name":"North Yorkshire"},{"code":"GB-OLD","name":"Oldham"},{"code":"GB-ORK","name":"Orkney Islands"},{"code":"GB-OXF","name":"Oxfordshire"},{"code":"GB-PEM","name":"Pembrokeshire; Sir Benfro"},{"code":"GB-PKN","name":"Perth and Kinross"},{"code":"GB-PLY","name":"Plymouth"},{"code":"GB-POL","name":"Poole"},{"code":"GB-POR","name":"Portsmouth"},{"code":"GB-POW","name":"Powys"},{"code":"GB-PTE","name":"Peterborough"},{"code":"GB-RCC","name":"Redcar and Cleveland"},{"code":"GB-RCH","name":"Rochdale"},{"code":"GB-RCT","name":"Rhondda, Cynon, Taff; Rhondda, Cynon, Taf"},{"code":"GB-RDB","name":"Redbridge"},{"code":"GB-RDG","name":"Reading"},{"code":"GB-RFW","name":"Renfrewshire"},{"code":"GB-RIC","name":"Richmond upon Thames"},{"code":"GB-ROT","name":"Rotherham"},{"code":"GB-RUT","name":"Rutland"},{"code":"GB-SAW","name":"Sandwell"},{"code":"GB-SAY","name":"South Ayrshire"},{"code":"GB-SCB","name":"Scottish Borders, The"},{"code":"GB-SCT","name":"Scotland"},{"code":"GB-SFK","name":"Suffolk"},{"code":"GB-SFT","name":"Sefton"},{"code":"GB-SGC","name":"South Gloucestershire"},{"code":"GB-SHF","name":"Sheffield"},{"code":"GB-SHN","name":"St. Helens"},{"code":"GB-SHR","name":"Shropshire"},{"code":"GB-SKP","name":"Stockport"},{"code":"GB-SLF","name":"Salford"},{"code":"GB-SLG","name":"Slough"},{"code":"GB-SLK","name":"South Lanarkshire"},{"code":"GB-SND","name":"Sunderland"},{"code":"GB-SOL","name":"Solihull"},{"code":"GB-SOM","name":"Somerset"},{"code":"GB-SOS","name":"Southend-on-Sea"},{"code":"GB-SRY","name":"Surrey"},{"code":"GB-STE","name":"Stoke-on-Trent"},{"code":"GB-STG","name":"Stirling"},{"code":"GB-STH","name":"Southampton"},{"code":"GB-STN","name":"Sutton"},{"code":"GB-STS","name":"Staffordshire"},{"code":"GB-STT","name":"Stockton-on-Tees"},{"code":"GB-STY","name":"South Tyneside"},{"code":"GB-SWA","name":"Swansea; Abertawe"},{"code":"GB-SWD","name":"Swindon"},{"code":"GB-SWK","name":"Southwark"},{"code":"GB-TAM","name":"Tameside"},{"code":"GB-TFW","name":"Telford and Wrekin"},{"code":"GB-THR","name":"Thurrock"},{"code":"GB-TOB","name":"Torbay"},{"code":"GB-TOF","name":"Torfaen; Tor-faen"},{"code":"GB-TRF","name":"Trafford"},{"code":"GB-TWH","name":"Tower Hamlets"},{"code":"GB-UKM","name":"United Kingdom"},{"code":"GB-VGL","name":"Vale of Glamorgan, The; Bro Morgannwg"},{"code":"GB-WAR","name":"Warwickshire"},{"code":"GB-WBK","name":"West Berkshire"},{"code":"GB-WDU","name":"West Dunbartonshire"},{"code":"GB-WFT","name":"Waltham Forest"},{"code":"GB-WGN","name":"Wigan"},{"code":"GB-WIL","name":"Wiltshire"},{"code":"GB-WKF","name":"Wakefield"},{"code":"GB-WLL","name":"Walsall"},{"code":"GB-WLN","name":"West Lothian"},{"code":"GB-WLS","name":"Wales; Cymru"},{"code":"GB-WLV","name":"Wolverhampton"},{"code":"GB-WND","name":"Wandsworth"},{"code":"GB-WNM","name":"Windsor and Maidenhead"},{"code":"GB-WOK","name":"Wokingham"},{"code":"GB-WOR","name":"Worcestershire"},{"code":"GB-WRL","name":"Wirral"},{"code":"GB-WRT","name":"Warrington"},{"code":"GB-WRX","name":"Wrexham; Wrecsam"},{"code":"GB-WSM","name":"Westminster"},{"code":"GB-WSX","name":"West Sussex"},{"code":"GB-YOR","name":"York"},{"code":"GB-ZET","name":"Shetland Islands"}],"currency":{"emoji":"💷","key":"GBP","symbol":"£","value":"Pound Sterling"}}}
curl --location --request GET 'https://zylalabs.com/api/4711/country+details+api/5817/country+information?country=UK' --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.
To use this API users must indicate the country code of a country.
The Country Details API provides comprehensive information on countries around the world through programmable access.
There are different plans to suit all tastes, including a free trial for a small number of requests, but your rate is limited to avoid 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 Country Details API provides country names, ISO codes (alpha-2 and alpha-3), flag emojis, call codes and administrative subdivisions.
The Country Details API returns detailed country information, including the official name, ISO codes (alpha-2 and alpha-3), flag emoji, international calling code, and administrative subdivisions.
Key fields in the response include "value" (country name), "key" (alpha-2 code), "cca3" (alpha-3 code), "emoji" (flag emoji), "calling_code" (international dialing code), and "subdivision" (administrative divisions).
The response data is structured in JSON format, with a main "data" object containing country details and an array of "subdivision" objects for administrative regions, each with unique codes and names.
The primary parameter for the endpoint is the country code, which can be either the ISO alpha-2 or alpha-3 code. This allows users to request specific country data.
The endpoint provides information on country names, ISO codes, flag emojis, calling codes, and details about subdivisions, enabling comprehensive country data retrieval.
Data accuracy is maintained through regular updates and validation against reliable sources, ensuring that the information provided is current and trustworthy.
Typical use cases include geolocation services, address auto-completion, phone number validation, regional content customization, and compliance with regulatory requirements.
Users can leverage the returned data to enhance applications by displaying country-specific information, validating user inputs, and personalizing content based on geographic location.
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.
Please have a look at our Refund Policy: https://zylalabs.com/terms#refund
Service Level:
100%
Response Time:
381ms
Service Level:
100%
Response Time:
373ms
Service Level:
100%
Response Time:
597ms
Service Level:
100%
Response Time:
245ms
Service Level:
100%
Response Time:
448ms
Service Level:
100%
Response Time:
600ms
Service Level:
100%
Response Time:
601ms
Service Level:
100%
Response Time:
3,420ms
Service Level:
100%
Response Time:
1,045ms
Service Level:
100%
Response Time:
709ms
Service Level:
100%
Response Time:
187ms
Service Level:
100%
Response Time:
369ms
Service Level:
100%
Response Time:
160ms
Service Level:
100%
Response Time:
995ms
Service Level:
100%
Response Time:
4,501ms
Service Level:
100%
Response Time:
8,724ms
Service Level:
99%
Response Time:
1,258ms
Service Level:
100%
Response Time:
812ms
Service Level:
100%
Response Time:
157ms
Service Level:
100%
Response Time:
495ms
