Alejandro MatosAbout this Project
This project is inspired on restcountries.eu by Fayder Florez. As it hasn't had any activity in at least 14 months, I decided to take action :)
REST Countries
You can access API through https://restcountries.com/v2/all
TODO:
- Add SSL
- [ ] Solve many issues reported in the GitHub page for original countries
- [ ] Add Chinese, Taiwanese and Hongkonian
Contributing
Any help is welcome! just the file that fits better and I will replicate the changes to the other files. This project uses the countries.min.json file
Donations
If you feel like helping me, you're welcome to donate or you can also buy me a coffee :)
API Endpoints
Below are described the REST endpoints available that you can use to search for countries
All
https://restcountries.com/v2/all
Name
Search by country name. It can be the native name or partial name
https://restcountries.com/v2/name/{name}
https://restcountries.com/v2/name/eesti
https://restcountries.com/v2/name/united
Full Name
Search by country full name
https://restcountries.com/v2/name/{name}?fullText=true
https://restcountries.com/v2/name/aruba?fullText=true
Code
Search by ISO 3166-1 2-letter or 3-letter country code
https://restcountries.com/v2/alpha/{code}
https://restcountries.com/v2/alpha/co
https://restcountries.com/v2/alpha/col
List of codes
Search by list of ISO 3166-1 2-letter or 3-letter country codes
https://restcountries.com/v2/alpha?codes={code},{code},{code}
https://restcountries.com/v2/alpha?codes=col,no,ee
Currency
Search by ISO 4217 currency code
https://restcountries.com/v2/currency/{currency}
https://restcountries.com/v2/currency/cop
Language
Search by ISO 639-1 language code
https://restcountries.com/v2/lang/{et}
https://restcountries.com/v2/lang/es
Capital city
Search by capital city
https://restcountries.com/v2/capital/{capital}
https://restcountries.com/v2/capital/tallinn
Calling code
Search by calling code
https://restcountries.com/v2/callingcode/{callingcode}
https://restcountries.com/v2/callingcode/372
Continent
Search by continent: Africa, Americas, Asia, Europe, Oceania
https://restcountries.com/v2/continent/{region}
https://restcountries.com/v2/continent/europe
Regional Bloc
Search by regional bloc:
- EU (European Union)
- EFTA (European Free Trade Association)
- CARICOM (Caribbean Community)
- PA (Pacific Alliance)
- AU (African Union)
- USAN (Union of South American Nations)
- EEU (Eurasian Economic Union)
- AL (Arab League)
- ASEAN (Association of Southeast Asian Nations)
- CAIS (Central American Integration System)
- CEFTA (Central European Free Trade Agreement)
- NAFTA (North American Free Trade Agreement)
- SAARC (South Asian Association for Regional Cooperation)
https://restcountries.com/v2/regionalbloc/{regionalbloc}
https://restcountries.com/v2/regionalbloc/eu
Response Example
https://restcountries.com/v2/alpha/col
[[{
"name": "Colombia",
"topLevelDomain": [".co"],
"alpha2Code": "CO",
"alpha3Code": "COL",
"callingCodes": ["57"],
"capital": "Bogotá",
"altSpellings": ["CO", "Republic of Colombia", "República de Colombia"],
"region": "Americas",
"subregion": "South America",
"population": 48759958,
"latlng": [4.0, -72.0],
"demonym": "Colombian",
"area": 1141748.0,
"gini": 55.9,
"timezones": ["UTC-05:00"],
"borders": ["BRA", "ECU", "PAN", "PER", "VEN"],
"nativeName": "Colombia",
"numericCode": "170",
"currencies": [{
"code": "COP",
"name": "Colombian peso",
"symbol": "$"
}],
"languages": [{
"iso639_1": "es",
"iso639_2": "spa",
"name": "Spanish",
"nativeName": "Español"
}],
"translations": {
"de": "Kolumbien",
"es": "Colombia",
"fr": "Colombie",
"ja": "コロンビア",
"it": "Colombia",
"br": "Colômbia",
"pt": "Colômbia"
},
"flag": "https://restcountries.com/data/col.svg",
"regionalBlocs": [{
"acronym": "PA",
"name": "Pacific Alliance",
"otherAcronyms": [],
"otherNames": ["Alianza del Pacífico"]
}, {
"acronym": "USAN",
"name": "Union of South American Nations",
"otherAcronyms": ["UNASUR", "UNASUL", "UZAN"],
"otherNames": ["Unión de Naciones Suramericanas", "União de Nações Sul-Americanas", "Unie van Zuid-Amerikaanse Naties", "South American Union"]
}]
}]
Filter Response
You can filter the output of your request to include only the specified fields.
https://restcountries.com/v2/{service}?fields={field},{field},{field}
https://restcountries.com/v2/all?fields=name,capital,currencies