UK Country Codes & Subdivisions: Complete ISO 3166-2:GB Reference (2026)

import { country } from '@koshmoney/countries';
 
// Correct: GB is the valid ISO alpha-2 code
country.whereAlpha2('GB');
// { name: 'United Kingdom of Great Britain and Northern Ireland', alpha2: 'GB', alpha3: 'GBR', numeric: '826' }
 
country.whereAlpha3('GBR');
// { name: 'United Kingdom of Great Britain and Northern Ireland', alpha2: 'GB', alpha3: 'GBR', numeric: '826' }
 
// UK is not a valid ISO 3166-1 alpha-2 code
country.isAlpha2('UK');  // false
country.whereAlpha2('UK');  // null

import { subdivision } from '@koshmoney/countries';
 
// Get all UK subdivisions (200+)
const all = subdivision.forCountry('GB');
console.log(all.length);  // 200+
 
// Get just the four constituent countries
const countries = subdivision.forCountry('GB')
  .filter(s => s.type === 'Country' || s.type === 'Province');
 
// [
//   { code: 'GB-ENG', name: 'England', type: 'Country', ... },
//   { code: 'GB-NIR', name: 'Northern Ireland', type: 'Province', ... },
//   { code: 'GB-SCT', name: 'Scotland', type: 'Country', ... },
//   { code: 'GB-WLS', name: 'Wales', type: 'Country', ... },
// ]

import { membership } from '@koshmoney/countries/membership';
 
membership.isEU('GB');        // false — left the EU in 2020
membership.isSEPA('GB');      // true  — still in SEPA
membership.isEurozone('GB');  // false — never adopted the Euro
membership.isSchengen('GB');  // false — never joined Schengen
 
// Ireland (IE) remains in the EU, creating a unique border situation
membership.isEU('IE');        // true
membership.isSEPA('IE');      // true
membership.isEurozone('IE');  // true

import { subdivision } from '@koshmoney/countries';
 
// England
subdivision.whereCode('GB-ENG');
// { code: 'GB-ENG', name: 'England', type: 'Country', countryCode: 'GB', regionCode: 'ENG' }
 
// Scottish council area
subdivision.whereCode('GB-EDH');
// { code: 'GB-EDH', name: 'Edinburgh, City of', type: 'Council area', countryCode: 'GB', regionCode: 'EDH' }
 
// London borough
subdivision.where('GB', 'MAN');
// { code: 'GB-MAN', name: 'Manchester', type: 'Metropolitan district', countryCode: 'GB', regionCode: 'MAN' }
 
// Welsh unitary authority
subdivision.where('GB', 'CRF');
// { code: 'GB-CRF', name: 'Cardiff', type: 'Unitary authority', countryCode: 'GB', regionCode: 'CRF' }

import { subdivision } from '@koshmoney/countries';
 
subdivision.isValidCode('GB-ENG');      // true  — England
subdivision.isValidCode('GB-SCT');      // true  — Scotland
subdivision.isValidCode('GB-WLS');      // true  — Wales
subdivision.isValidCode('GB-NIR');      // true  — Northern Ireland
subdivision.isValidCode('GB-LON');      // false — not a valid code
subdivision.isValidCode('GB-UK');       // false — not valid
 
subdivision.isValidRegion('GB', 'ENG'); // true
subdivision.isValidRegion('GB', 'WLS'); // true
subdivision.isValidRegion('GB', 'ENG'); // true

import { subdivision } from '@koshmoney/countries';
 
// Simple constituent countries dropdown
const ukCountryOptions = subdivision.forCountry('GB')
  .filter(s => s.type === 'Country' || s.type === 'Province')
  .map(s => ({
    value: s.code.split('-')[1],  // 'ENG', 'SCT', 'WLS', 'NIR'
    label: s.name,
  }));
 
// [
//   { value: 'ENG', label: 'England' },
//   { value: 'NIR', label: 'Northern Ireland' },
//   { value: 'SCT', label: 'Scotland' },
//   { value: 'WLS', label: 'Wales' },
// ]

import { subdivision } from '@koshmoney/countries';
 
// For address forms targeting a specific country within the UK,
// you can filter by the type relevant to that country
function getSubdivisionsForUKCountry(ukCountry: 'england' | 'scotland' | 'wales' | 'northern-ireland') {
  const all = subdivision.forCountry('GB');
 
  // Note: filtering by type gives approximate results
  // For production, maintain a mapping of codes to constituent countries
  const typeMap = {
    'england': ['London borough', 'Metropolitan district', 'Unitary authority', 'Two-tier county', 'City corporation'],
    'scotland': ['Council area'],
    'wales': ['Unitary authority'],  // Wales uses the same type as some English areas
    'northern-ireland': ['District council area'],
  };
 
  return all.filter(s => typeMap[ukCountry].includes(s.type));
}

import { postalCode } from '@koshmoney/countries';
 
// England
postalCode.isValid('GB', 'SW1A 1AA');   // true  — Westminster (Buckingham Palace area)
postalCode.isValid('GB', 'EC2R 8AH');   // true  — City of London
postalCode.isValid('GB', 'M1 1AE');     // true  — Manchester city centre
postalCode.isValid('GB', 'B1 1BB');     // true  — Birmingham
 
// Scotland
postalCode.isValid('GB', 'EH1 1YZ');    // true  — Edinburgh
postalCode.isValid('GB', 'G1 1AA');     // true  — Glasgow
 
// Wales
postalCode.isValid('GB', 'CF10 1EP');   // true  — Cardiff
 
// Northern Ireland
postalCode.isValid('GB', 'BT1 1AA');    // true  — Belfast (BT prefix = Northern Ireland)
 
// Invalid
postalCode.isValid('GB', '12345');      // false — US ZIP format
postalCode.isValid('GB', 'INVALID');    // false
 
postalCode.getName('GB');    // 'Postcode'
postalCode.getFormat('GB');  // 'AA9A 9AA'

import { country } from '@koshmoney/countries';
import { membership } from '@koshmoney/countries/membership';
 
interface ShipmentRoute {
  originAlpha2: string;
  destinationAlpha2: string;
}
 
function getShippingRequirements(route: ShipmentRoute) {
  const { originAlpha2, destinationAlpha2 } = route;
 
  const originEU = membership.isEU(originAlpha2);
  const destinationEU = membership.isEU(destinationAlpha2);
  const originSepa = membership.isSEPA(originAlpha2);
  const destinationSepa = membership.isSEPA(destinationAlpha2);
 
  const isGBShipment = originAlpha2 === 'GB' || destinationAlpha2 === 'GB';
  const crossesEUGBBorder =
    (originAlpha2 === 'GB' && destinationEU) ||
    (destinationAlpha2 === 'GB' && originEU);
 
  return {
    requiresCustomsDeclaration: crossesEUGBBorder,
    requiresVATRegistration: crossesEUGBBorder,
    sepaPaymentsAvailable: originSepa && destinationSepa,
    euVatApplies: originEU && destinationEU,
    ukVatApplies: isGBShipment,
  };
}
 
// GB to France
getShippingRequirements({ originAlpha2: 'GB', destinationAlpha2: 'FR' });
// { requiresCustomsDeclaration: true, requiresVATRegistration: true, sepaPaymentsAvailable: true, ... }
 
// Germany to France (EU-EU)
getShippingRequirements({ originAlpha2: 'DE', destinationAlpha2: 'FR' });
// { requiresCustomsDeclaration: false, requiresVATRegistration: false, ... }

import { membership } from '@koshmoney/countries/membership';
 
function getPrivacyRegime(alpha2: string): string {
  if (membership.isEU(alpha2)) {
    return 'EU GDPR — supervised by national DPA';
  }
  if (alpha2 === 'GB') {
    return 'UK GDPR — supervised by ICO (Information Commissioner\'s Office)';
  }
  // Other countries may have their own privacy laws
  return 'Local privacy law — verify jurisdiction requirements';
}
 
getPrivacyRegime('GB');  // 'UK GDPR — supervised by ICO (Information Commissioner's Office)'
getPrivacyRegime('DE');  // 'EU GDPR — supervised by national DPA'
getPrivacyRegime('IE');  // 'EU GDPR — supervised by national DPA'

npm install @koshmoney/countries

import { country, subdivision, postalCode } from '@koshmoney/countries';
import { membership } from '@koshmoney/countries/membership';
 
// UK country data
const uk = country.whereAlpha2('GB');
// { name: 'United Kingdom...', alpha2: 'GB', alpha3: 'GBR', numeric: '826' }
 
// All UK constituent countries
const ukCountries = subdivision.forCountry('GB')
  .filter(s => ['Country', 'Province'].includes(s.type));
 
// UK membership status (post-Brexit)
const ukStatus = {
  eu: membership.isEU('GB'),        // false
  sepa: membership.isSEPA('GB'),    // true
  eurozone: membership.isEurozone('GB'), // false
  schengen: membership.isSchengen('GB'), // false
};
 
// UK postcode validation
const isValidPostcode = postalCode.isValid('GB', 'SW1A 1AA'); // true