Access comprehensive global country data including name, ISO code, flag emoji, calling code, and subdivisions with the Country Data API.
Run in Postman
{"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'
After signing up, every developer is assigned a personal API access key, a unique combination of letters and digits provided to access to our API endpoint. To authenticate with the Country Details API simply include your bearer token in the Authorization header.
| 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.
(Save 2 months with annual billing 🎉)
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 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, first sign in to your account and navigate to the API you want to use. From the API's Pricing section, choose a plan and complete the subscription process. Once subscribed, return to the API page and you will see your API Access Key displayed at the top of the documentation page. You can use this key 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.
The free trial lasts for 7 days and allows you to make up to 50 API requests.
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. If the API offers a free trial, you will see a "Free 7-Day Trial" option in its Pricing section. The trial lasts for 7 days and allows up to 50 API requests, enabling you to evaluate the API before subscribing to a paid plan.
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.
You can monitor your API usage through the response headers included with every request:
x-zyla-api-calls-monthly-used: Shows the total number of API requests you have used during the current billing period.
x-zyla-api-calls-monthly-remaining: Shows the number of API requests you have remaining for the current billing period.
Yes, you can cancel your subscription at any time. Simply go to the Pricing section of the API you're subscribed to and click the "Unsubscribe" button.
Please note that upgrades, downgrades, and cancellations take effect immediately. Once your subscription is canceled, access to the service will end immediately, regardless of any remaining API calls in your quota.
Please have a look at our Refund Policy: https://zylalabs.com/terms#refund
