{"id":13682105,"url":"https://github.com/apilayer/restcountries","last_synced_at":"2025-09-27T10:30:37.105Z","repository":{"id":40625830,"uuid":"13450509","full_name":"apilayer/restcountries","owner":"apilayer","description":"Get information about countries via a RESTful API","archived":true,"fork":false,"pushed_at":"2023-11-27T06:33:03.000Z","size":11459,"stargazers_count":2250,"open_issues_count":52,"forks_count":356,"subscribers_count":56,"default_branch":"master","last_synced_at":"2025-01-14T15:00:35.231Z","etag":null,"topics":["countries","java","rest","rest-api","rest-countries"],"latest_commit_sha":null,"homepage":"https://restcountries.eu","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/apilayer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-10-09T18:33:15.000Z","updated_at":"2025-01-13T12:34:18.000Z","dependencies_parsed_at":"2024-08-02T13:21:47.913Z","dependency_job_id":"aa33fc6b-0465-4dc3-b987-f98009595385","html_url":"https://github.com/apilayer/restcountries","commit_stats":null,"previous_names":[],"tags_count":19,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apilayer%2Frestcountries","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apilayer%2Frestcountries/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apilayer%2Frestcountries/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/apilayer%2Frestcountries/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/apilayer","download_url":"https://codeload.github.com/apilayer/restcountries/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234425990,"owners_count":18830828,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["countries","java","rest","rest-api","rest-countries"],"created_at":"2024-08-02T13:01:40.829Z","updated_at":"2025-09-27T10:30:30.297Z","avatar_url":"https://github.com/apilayer.png","language":"Java","funding_links":["https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=V5AJAEMKE6A3E"],"categories":["Java"],"sub_categories":[],"readme":"REST Countries\n=======\n\nGet information about countries via a RESTful API https://restcountries.eu\n\n[![Build Status](https://travis-ci.org/fayder/restcountries.svg?branch=master)](https://travis-ci.org/fayder/restcountries)\n\nDonate!\n---------------\nThe restcountries project has been acquired by apilayer, one of the leading providers of API microservices. We will keep supporting restcountries and providing it as a free solution for developers. We will finance this project fully and have turned off the donations feature.\n\nUsers\n---------------\nRESTCountries has over 1200 users, including:\n\n[TTÜ]\n\n[Spotify International Pricing Index]\n\n[Gorillaz]\n\n[Wanderlust]\n\n[Xero]\n\n[FxPro]\n\n[SKROSS]\n\n[onefinestay]\n\n[Much Better Adventures]\n\nStay up-to-date\n---------------\nFollow RESTCountries on [Twitter]\n\nOr subscribe to the [mailing list]\n\nAPI Endpoints\n=======\n\nBelow are described the REST endpoints available that you can use to search for countries\n\nAll\n---------------\n\n``` html\nhttps://restcountries.eu/rest/v2/all\n```\n\nName\n---------------\n\nSearch by country name. It can be the native name or partial name\n\n``` javascript\nhttps://restcountries.eu/rest/v2/name/{name}\n```\n\n``` html\nhttps://restcountries.eu/rest/v2/name/eesti\n```\n\n``` html\nhttps://restcountries.eu/rest/v2/name/united\n```\n\nFull Name\n---------------\n\nSearch by country full name\n\n``` javascript\nhttps://restcountries.eu/rest/v2/name/{name}?fullText=true\n```\n\n``` html\nhttps://restcountries.eu/rest/v2/name/aruba?fullText=true\n```\n\nCode\n---------------\n\nSearch by ISO 3166-1 2-letter or 3-letter country code\n\n``` javascript\nhttps://restcountries.eu/rest/v2/alpha/{code}\n```\n\n``` html\nhttps://restcountries.eu/rest/v2/alpha/co\n```\n\n``` html\nhttps://restcountries.eu/rest/v2/alpha/col\n```\n\nList of codes\n---------------\n\nSearch by list of ISO 3166-1 2-letter or 3-letter country codes\n\n``` javascript\nhttps://restcountries.eu/rest/v2/alpha?codes={code};{code};{code}\n```\n\n``` html\nhttps://restcountries.eu/rest/v2/alpha?codes=col;no;ee\n```\n\nCurrency\n---------------\n\nSearch by ISO 4217 currency code\n\n``` javascript\nhttps://restcountries.eu/rest/v2/currency/{currency}\n```\n``` html\nhttps://restcountries.eu/rest/v2/currency/cop\n```\n\nLanguage\n---------------\n\nSearch by ISO 639-1 language code\n\n``` javascript\nhttps://restcountries.eu/rest/v2/lang/{et}\n```\n``` html\nhttps://restcountries.eu/rest/v2/lang/es\n```\n\nCapital city\n---------------\n\nSearch by capital city\n\n``` javascript\nhttps://restcountries.eu/rest/v2/capital/{capital}\n```\n``` html\nhttps://restcountries.eu/rest/v2/capital/tallinn\n```\n\nCalling code\n---------------\n\nSearch by calling code\n\n``` javascript\nhttps://restcountries.eu/rest/v2/callingcode/{callingcode}\n```\n``` html\nhttps://restcountries.eu/rest/v2/callingcode/372\n```\n\nRegion\n---------------\n\nSearch by region: Africa, Americas, Asia, Europe, Oceania\n\n``` javascript\nhttps://restcountries.eu/rest/v2/region/{region}\n```\n``` html\nhttps://restcountries.eu/rest/v2/region/europe\n```\n\nRegional Bloc\n---------------\n\nSearch by regional bloc:\n\n- EU (European Union)\n- EFTA (European Free Trade Association)\n- CARICOM (Caribbean Community)\n- PA (Pacific Alliance)\n- AU (African Union)\n- USAN (Union of South American Nations)\n- EEU (Eurasian Economic Union)\n- AL (Arab League)\n- ASEAN (Association of Southeast Asian Nations)\n- CAIS (Central American Integration System)\n- CEFTA (Central European Free Trade Agreement)\n- NAFTA (North American Free Trade Agreement)\n- SAARC (South Asian Association for Regional Cooperation)\n\n``` javascript\nhttps://restcountries.eu/rest/v2/regionalbloc/{regionalbloc}\n```\n``` html\nhttps://restcountries.eu/rest/v2/regionalbloc/eu\n```\n\nResponse Example\n---------------\n\n``` html\nhttps://restcountries.eu/rest/v2/alpha/col\n```\n\n``` json\n[[{\n\t\"name\": \"Colombia\",\n\t\"topLevelDomain\": [\".co\"],\n\t\"alpha2Code\": \"CO\",\n\t\"alpha3Code\": \"COL\",\n\t\"callingCodes\": [\"57\"],\n\t\"capital\": \"Bogotá\",\n\t\"altSpellings\": [\"CO\", \"Republic of Colombia\", \"República de Colombia\"],\n\t\"region\": \"Americas\",\n\t\"subregion\": \"South America\",\n\t\"population\": 48759958,\n\t\"latlng\": [4.0, -72.0],\n\t\"demonym\": \"Colombian\",\n\t\"area\": 1141748.0,\n\t\"gini\": 55.9,\n\t\"timezones\": [\"UTC-05:00\"],\n\t\"borders\": [\"BRA\", \"ECU\", \"PAN\", \"PER\", \"VEN\"],\n\t\"nativeName\": \"Colombia\",\n\t\"numericCode\": \"170\",\n\t\"currencies\": [{\n\t\t\"code\": \"COP\",\n\t\t\"name\": \"Colombian peso\",\n\t\t\"symbol\": \"$\"\n\t}],\n\t\"languages\": [{\n\t\t\"iso639_1\": \"es\",\n\t\t\"iso639_2\": \"spa\",\n\t\t\"name\": \"Spanish\",\n\t\t\"nativeName\": \"Español\"\n\t}],\n\t\"translations\": {\n\t\t\"de\": \"Kolumbien\",\n\t\t\"es\": \"Colombia\",\n\t\t\"fr\": \"Colombie\",\n\t\t\"ja\": \"コロンビア\",\n\t\t\"it\": \"Colombia\",\n\t\t\"br\": \"Colômbia\",\n\t\t\"pt\": \"Colômbia\"\n\t},\n\t\"flag\": \"https://restcountries.eu/data/col.svg\",\n\t\"regionalBlocs\": [{\n\t\t\"acronym\": \"PA\",\n\t\t\"name\": \"Pacific Alliance\",\n\t\t\"otherAcronyms\": [],\n\t\t\"otherNames\": [\"Alianza del Pacífico\"]\n\t}, {\n\t\t\"acronym\": \"USAN\",\n\t\t\"name\": \"Union of South American Nations\",\n\t\t\"otherAcronyms\": [\"UNASUR\", \"UNASUL\", \"UZAN\"],\n\t\t\"otherNames\": [\"Unión de Naciones Suramericanas\", \"União de Nações Sul-Americanas\", \"Unie van Zuid-Amerikaanse Naties\", \"South American Union\"]\n\t}]\n}]\n```\n\nFilter Response\n=======\n\nYou can filter the output of your request to include only the specified fields.\n\n``` javascript\nhttps://restcountries.eu/rest/v2/{service}?fields={field};{field};{field}\n```\n``` html\nhttps://restcountries.eu/rest/v2/all?fields=name;capital;currencies\n```\n\nSources\n=======\n* [@mledoze]\n* [List of countries]\n* [Languages]\n* [Currencies]\n* [Area]\n\nSimilar projects\n=======\n* [Countries of the world]\n* [REST Countries Node.js]\n* [REST Countries Ruby]\n* [REST Countries Go]\n* [REST Countries Python]\n* [world-currencies]\n* [REST Countries C#](https://github.com/egbakou/RESTCountries.NET)\n\nLicense\n=======\n[Mozilla Public License] MPL 2.0\n\n[dist]: https://github.com/fayder/restcountries/\n[Twitter]: https://twitter.com/restcountries\n[mailing list]: http://eepurl.com/cC-h2v\n[Donate]: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=V5AJAEMKE6A3E\n[@mledoze]: https://github.com/mledoze/countries\n[List of countries]: https://en.wikipedia.org/wiki/ISO_3166-1#Current_codes\n[Languages]: https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes\n[Currencies]: https://en.wikipedia.org/wiki/List_of_circulating_currencies\n[Area]: https://en.wikipedia.org/wiki/List_of_countries_and_dependencies_by_area\n[Population]: https://en.wikipedia.org/wiki/List_of_countries_by_population\n[Gini coefficient]: http://en.wikipedia.org/wiki/List_of_countries_by_income_equality\n[Mozilla Public License]: https://www.mozilla.org/en-US/MPL/2.0/\n[world-currencies]: https://github.com/wiredmax/world-currencies\n[REST Countries Node.js]: https://github.com/aredo/restcountries\n[REST Countries Ruby]: https://github.com/davidesantangelo/restcountry\n[REST Countries Go]: https://github.com/alediaferia/gocountries\n[REST Countries Python]: https://github.com/SteinRobert/python-restcountries\n[Countries of the world]: http://countries.petethompson.net\n[TTÜ]: https://www.ttu.ee/studying/tut_admission/programmes-in-tut/ask-us/\n[Spotify International Pricing Index]: http://mts.io/2014/05/07/spotify-pricing-index/\n[Gorillaz]: http://www.gorillaz.com/\n[Wanderlust]: https://wanderlust.com/\n[Xero]: https://www.xero.com/\n[FxPro]: http://www.fxpro.com/\n[onefinestay]: https://www.onefinestay.com/\n[Much Better Adventures]: https://www.muchbetteradventures.com\n[SKROSS]: http://www.skross.com/en\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapilayer%2Frestcountries","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fapilayer%2Frestcountries","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fapilayer%2Frestcountries/lists"}