Blog·Note·

We put the data on GitHub

ParseAPI lists publishes JSON and CSV reference files on GitHub under CC0, with daily exchange-rate updates and monthly updates for the other lists.

Sometimes you just need a country list in your application. Making a request every time someone opens a dropdown would be unnecessary, and keeping your own copy lets you decide when it changes.

We publish those files at github.com/parseapi/lists. The repository includes countries, states, counties, languages, timezones, currencies, area codes, and exchange rates based on the euro. Each list is available as JSON and CSV under CC0.

The paths follow the same pattern, such as countries/countries.json and countries/countries.csv. You can fetch a raw file directly:

GET https://raw.githubusercontent.com/parseapi/lists/main/countries/countries.json

Here is a shortened country record from that file:

{
  "country": "AD",
  "iso3": "AND",
  "numeric": 20,
  "name": "Andorra",
  "capital": "Andorra la Vella",
  "continent": "EU",
  "currency": "EUR",
  "calling_code": "+376"
}

The files are generated from the API. Exchange rates refresh daily, and the other lists refresh monthly. Records use a stable order, so a run with no data changes produces the same file. That makes the changes easier to review in a diff.

Fetch the current version when you need it, or pin a commit and keep a copy in your project. The files do not need an API key.