Search by task, endpoint, field, or error.

← 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
Explore
Parameters 1
codestring · path · required

Bloc code

Values: EU, EEA, EFTA, SCHENGEN, EUROZONE, SEPA, NATO, OECD, G7, ASEAN, GCC, MERCOSUR

Run uses the free demo on API 2.0.0. Copied code uses your API key when signed in, or YOUR_API_KEY when signed out.

SDK quickstart
import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.bloc("eu");
console.log(result);

Run on your server with a secret key. Calling from a browser or app?

Example response
{
  "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
Explore
Parameters 2
codestring · path · required

Bloc code

Values: EU, EEA, EFTA, SCHENGEN, EUROZONE, SEPA, NATO, OECD, G7, ASEAN, GCC, MERCOSUR

langstring · query · optional

Display language as one BCP 47 tag, such as fr or zh-Hant. Changes supported display labels only; IDs, codes, native names, facts, parsing and deep access stay unchanged. Omit for the original response. Unsupported regions use the supported language base; unsupported languages or scripts use English. Missing labels retain their source value. Accept-Language is not read automatically. Available on the current API contract; frozen 1.0.0 is unchanged.

Run uses the free demo on API 2.0.0. Copied code uses your API key when signed in, or YOUR_API_KEY when signed out.

SDK quickstart
import { parseAPI } from '@parseapi/sdk';

const parse = parseAPI("YOUR_API_KEY");
const result = await parse.bloc.countries("schengen");
console.log(result);

Run on your server with a secret key. Calling from a browser or app?

Example response
{
  "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[].calling_code
International calling code with plus (+1, +44)

On country

Paid /country/{code}?deep=true responses carry a deep.blocs array with that country's memberships.

Display language

Pass lang with a language tag such as fr, pt-BR, or zh-Hant. Country names and currency names in the countries list. The bloc name stays unchanged.

Omitting lang preserves the original response. Codes, IDs, numeric facts and native-name fields stay unchanged. Missing translations keep their existing source value; unknown values stay null. A preserved name_local may equal the translated name.

Send a chosen browser preference explicitly, for example { lang: navigator.language } in your JavaScript SDK options. The API does not read Accept-Language automatically. Unsupported regions fall back to their supported base language; unsupported languages or scripts use English. Empty, invalid or repeated tags return 400.

Content-Language identifies languages used in translated display fields and known English fallbacks. This option follows the current API contract. Requests selecting frozen 1.0.0 retain that contract. Select API 2.0.0 to use display language.

41 display language choices
Language tagLanguage
enAmerican English
zh-Hans简体中文
frfrançais (France)
deDeutsch
ititaliano
ja日本語
ko한국어
esespañol de España
arالعربية
bgбългарски
cacatalà
hrhrvatski
csčeština
dadansk
nlNederlands
fisuomi
elΕλληνικά
heעברית
hiहिन्दी
humagyar
idIndonesia
kkқазақ тілі
msMelayu
nbnorsk bokmål
plpolski
ptportuguês (Brasil)
roromână
ruрусский
skslovenčina
svsvenska
thไทย
trTürkçe
ukукраїнська
viTiếng Việt
zh-Hant繁體中文
en-AUAustralian English
en-GBBritish English
fr-CAfrançais canadien
es-419español latinoamericano
pt-PTportuguês europeu
zh-Hant-HK繁體中文（中國香港特別行政區）

Questions? Email