Country codes · Localization · State lists

Country API

Make your app
feel local.

Turn a country code or name into the currency, languages and timezones your app needs. Build country and state pickers with consistent codes and readable names.

Country lookups and state lists on every plan.

Try a country code or name

Try it

Run example (Command+Enter or Ctrl+Enter)
Example response/country/de
{
  "country": "DE",
  "iso_alpha3": "DEU",
  "iso_numeric": 276,
  "name": "Germany",
  "name_full": "Federal Republic of Germany",
  "name_local": "Deutschland",
  "demonym": "German",
  "continent": "EU",
  "region": "Europe",
  "subregion": "Western Europe",
  "currency": "EUR",
  "currency_name": "Euro",
  "currency_symbol": "€",
  "calling_code": "+49",
  "flag": "🇩🇪",
  "languages": ["de"],
  "timezones": ["Europe/Berlin", "Europe/Zurich"],
  
    "AT",
    "BE",
    "CH",
    "CZ",
    "DK",
    "FR",
    "LU",
    "NL",
    "PL"
  ],
  
    "EEA",
    "EU",
    "EUROZONE",
    "G7",
    "NATO",
    "OECD",
    "SCHENGEN",
    "SEPA"
  ],
  
    "name": "Berlin",
    "latitude": 52.52,
    "longitude": 13.4
  },
  "population": 83516593,
  "gdp_usd": 5050922925047.05,
  "gdp_per_capita_usd": 60496.44,
  "population_growth_percent": -0.03,
  "urban_population_percent": 82.14,
  "internet_users_percent": 93.5,
  "area": 357021,
  "land_area": null,
  "water_area": null,
  "coastline": 2389,
  "elevation_average": 263,
  
    "name": "Neuendorf bei Wilster",
    "elevation": -3.5
  },
  
    "name": "Zugspitze",
    "elevation": 2963
  },
  "tld": ".de",
  "week_start": "monday",
  "units": "metric",
  "driving_side": "right",
  "plugs": ["C", "F"],
  "voltage": 230,
  "frequency": 50,
  
    "police": "110",
    "ambulance": "112",
    "fire": "112"
  },
  "postal_format": "#####",
  "postal_regex": "^(?:\\d{5})$",
  
    "name": "VAT",
    "rate": 19
  },
  "ioc": "GER",
  "fifa": "GER",
  "plate": "D"
}

Highlighted fields: Included on paid plans.

From input to integration

A country.
Ready for your app.

Look up a code or a name, load its states, or add a richer profile. Each example pairs the request with the complete JSON response.

One code. The facts your app needs.

Germany returns country names, demonym, region, currency, calling code, languages, timezone IDs, borders, capital and postal-code format guidance. This is the complete ordinary response, available on every plan.

Request

curl "https://api.parseapi.com/country/de" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Version: 2.2.0"

Example response

JSON200 OK
{
  "country": "DE",
  "iso_alpha3": "DEU",
  "iso_numeric": 276,
  "name": "Germany",
  "name_full": "Federal Republic of Germany",
  "name_local": "Deutschland",
  "demonym": "German",
  "continent": "EU",
  "region": "Europe",
  "subregion": "Western Europe",
  "currency": "EUR",
  "currency_name": "Euro",
  "currency_symbol": "€",
  "calling_code": "+49",
  "flag": "🇩🇪",
  "languages": ["de"],
  "timezones": ["Europe/Berlin", "Europe/Zurich"],
  "borders": [
    "AT",
    "BE",
    "CH",
    "CZ",
    "DK",
    "FR",
    "LU",
    "NL",
    "PL"
  ],
  "blocs": [
    "EEA",
    "EU",
    "EUROZONE",
    "G7",
    "NATO",
    "OECD",
    "SCHENGEN",
    "SEPA"
  ],
  "capital": {
    "name": "Berlin",
    "latitude": 52.52,
    "longitude": 13.4
  },
  "population": 83516593,
  "gdp_usd": 5050922925047.05,
  "gdp_per_capita_usd": 60496.44,
  "population_growth_percent": -0.03,
  "urban_population_percent": 82.14,
  "internet_users_percent": 93.5,
  "area": 357021,
  "land_area": null,
  "water_area": null,
  "coastline": 2389,
  "elevation_average": 263,
  "lowest_point": {
    "name": "Neuendorf bei Wilster",
    "elevation": -3.5
  },
  "highest_point": {
    "name": "Zugspitze",
    "elevation": 2963
  },
  "tld": ".de",
  "week_start": "monday",
  "units": "metric",
  "driving_side": "right",
  "plugs": ["C", "F"],
  "voltage": 230,
  "frequency": 50,
  "emergency": {
    "police": "110",
    "ambulance": "112",
    "fire": "112"
  },
  "postal_format": "#####",
  "postal_regex": "^(?:\\d{5})$",
  "tax": {
    "name": "VAT",
    "rate": 19
  },
  "ioc": "GER",
  "fifa": "GER",
  "plate": "D"
}

Highlighted fields: Included on paid plans.

Country outlines · GeoJSON

Put a country
on the map.

Choose a country. See its outline on the map. Pan and zoom to explore.

Add format=geojson to get the country outline as geographic coordinates, ready for your map.

Country GeoJSON reference
Choose a country to load its outline.Drag to pan · + / − to zoom
Country GeoJSON · HTTP
curl "https://api.parseapi.com/country/US?format=geojson" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "X-API-Version: 2.2.0"

Country and state dropdowns

Choose a country.
Load its states.

Keep country and state fields connected. Fetch the country list for your first picker, then load the selected country's states, provinces or territories.

Store the subdivision code. Show the name. Use the type to choose the right label for your address form.

Build the dropdown flow

Australia

8 states and territories
  • ACTAustralian Capital Territoryterritory
  • NSWNew South Walesstate
  • NTNorthern Territoryterritory
  • QLDQueenslandstate
  • SASouth Australiastate
  • TASTasmaniastate
  • VICVictoriastate
  • WAWestern Australiastate

Example state list. Complete request and JSON above.

Example paid profile

Germany

Deutschland · DE

Capital
Berlin
Currency
EUR
Week starts
monday
Measurement
metric
Drives on
right
Power
230 V / 50 Hz

Detailed when you need it

Go beyond
the country code.

Add a country profile for travel guides, regional settings and location context. Read statistics, physical geography and local conventions alongside the ordinary country facts.

Paid plans include this profile detail automatically. The ordinary country fields stay in place, with optional profile fields beside them.

Explore country profiles

Add form.js to your fields

Start with a country.

Connect country, state and county dropdowns with form.js. Each selection loads the choices for the next field.

County lists cover the US, France and Great Britain. The Form demo also shows editable inputs with suggestions for manual entry.

Try connected dropdowns

Include the script once with your website's domain-restricted public key. Use these bindings in your existing form.

Form example
Country
United StatesUS
State or province
DelawareDE
County or district
Kent County10001

Country → State → County. Show names and save codes.

Add form.js to these fields
Your form · HTML
<script src="https://cdn.parseapi.com/v1/form.js?v=c18e1976f5b8"
        data-key="parse_public_YOUR_KEY" data-parse-version="2.2.0" defer></script>

<label for="form-country">Country</label>
<select id="form-country" name="country" data-parse="country">
  <option value="">Choose a country</option>
  <option value="US">United States</option>
  <option value="CA">Canada</option>
  <option value="GB">United Kingdom</option>
  <option value="FR">France</option>
</select>

<label for="form-state">State or province</label>
<select id="form-state" name="state" data-parse="state"
        data-parse-from="form-country" data-parse-fill="states">
  <option value="">Choose a state or province</option>
</select>

<label for="form-district">County or district</label>
<select id="form-district" name="county"
        data-parse-from="form-state" data-parse-fill="counties">
  <option value="">Choose a county or district</option>
</select>

From the first request to your app

One key.
Your language.

Copy a request, keep the country code, and use the names in your interface. Expand language and regional codes with the related APIs when you need more detail.

Country API reference

Build with Language and State.

HTTP, SDKs and MCP

Use the same API key across ParseAPI. The reference covers parameters, responses, authentication and errors.

Before you build.

Can I draw country outlines on a map?

Add format=geojson for a simplified country land outline, with the country code as its feature ID and the same selected facts in properties. Use countries on the GeoJSON collection to select up to 50 codes. Missing outlines keep null geometry.

Can I use an ISO code or a country name?

Yes. Use a two-letter ISO2 code, a three-letter ISO3 code or a supported country name. US, USA and United States resolve to the same record. Name matching is case-insensitive and accepts supported local names.

How do I build country and state dropdowns?

GET /country returns the country list with codes, names, flags and calling codes. After a country is selected, GET /country/{code}/states returns its recorded subdivisions with codes, names and types. Both lists are available on every plan.

What is included with a free API key?

Country lookup, the country list and state lists use your API request allowance on every plan. The ordinary lookup includes country names and codes, demonym, region, currency, calling code, flag, language codes, timezone IDs, borders, memberships, capital and postal-code format guidance. Paid plans include the available country profile automatically.

What do paid plans include?

Paid country lookups automatically include population, area, economic statistics, physical geography, local conventions, tax references and specialist identifiers. Capital, borders, country-group memberships and postal-code format guidance are already in Core. Core fields keep the same values. Unavailable detail stays null. Optional fields are absent when the plan or key does not include them.

Is name_local a translated label?

name is the English display name. name_local is the country's own name, such as Japan and 日本. It is null when absent or identical to name. It does not change with the visitor's language.

Which timezone should I use for a person or address?

Country returns a list of IANA timezone IDs associated with the country. Use a more specific place or coordinate to choose the timezone for an address. The Time API resolves local time and conversions for supported locations.

How should I read statistics and geography?

Population and geographic fields are reference facts with separate coverage. Area is in square kilometers, coastline in kilometers and elevations in meters. Geographic detail includes archived observations. Missing values stay null.

Can I calculate checkout tax from tax.rate?

tax.rate is the standard national reference rate in percent, so 19 means 19%. It is not a transaction-specific tax calculation. Product, location and exemption rules can change the amount due. The US has a null national rate because it has no national sales tax.

Country API pricing

Put country data to work.

Start free with country lookups and state lists. Paid plans include the available profile detail automatically. Your request allowance is shared across ParseAPI products.

Free

Start with a free API key.

Country data and state lists

Room to grow

Choose your capacity on Plans.

Country data, state lists and paid profiles