← Docs

Bloc API

A country group by code, or every member in it.

Look up a country group by code. The EU is not the Eurozone, and neither is Schengen. Each bloc is its own official member list.

Member lists are effective-dated, so an accession counts from the day it takes effect. Bare GET /bloc lists all twelve.

By code

Pass a code: EU, EEA, EFTA, SCHENGEN, EUROZONE, SEPA, NATO, OECD, G7, ASEAN, GCC, or MERCOSUR. The official name and the current member count come back.

GET
api.parseapi.com/bloc/{code}
Official name and current member count
curl "https://api.parseapi.com/bloc/eu" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "bloc": "EU",
  "name": "European Union",
  "members": 27
}

Response fields

bloc
Bloc code (EU, EEA, EFTA, SCHENGEN, EUROZONE, SEPA, NATO, OECD, G7, ASEAN, GCC, MERCOSUR)
name
Official name
members
Current member count
countries
On /bloc/{code}/countries: every current member with name, flag emoji, and calling code

Members

Every current member with its flag and calling code. GDPR territory tracks the EEA, so /bloc/eea/countries is that list.

GET
api.parseapi.com/bloc/{code}/countries
Every current member country
curl "https://api.parseapi.com/bloc/schengen/countries" \
  -H "X-API-Key: YOUR_API_KEY"
{
  "bloc": "SCHENGEN",
  "countries": [
    {
      "country": "AT",
      "name": "Austria",
      "calling_code": "+43"
    },
    {
      "country": "BE",
      "name": "Belgium",
      "calling_code": "+32"
    },
    {
      "country": "BG",
      "name": "Bulgaria",
      "calling_code": "+359"
    },
    // ... 26 more
  ]
}

Response fields

bloc
Bloc code
countries[].country
ISO2 country code
countries[].name
Country name
countries[].emoji
Flag emoji
countries[].calling_code
International calling code with plus (+1, +44)

On country

Every /country response carries a blocs array with that country's memberships.

Questions? Email