South Korean Province Codes: Complete ISO 3166-2:KR Reference (2026)

import { subdivision } from '@koshmoney/countries';
 
// Get all 17 subdivisions of South Korea
const krSubs = subdivision.getByCountry('KR');
console.log(krSubs.length); // 17
 
// Each subdivision has: code, name, type
krSubs.forEach((sub) => {
  console.log(`${sub.code}: ${sub.name} (${sub.type})`);
});

import { subdivision } from '@koshmoney/countries';
 
subdivision.get('KR-11');
// { code: 'KR-11', name: 'Seoul', type: 'Special city' }
 
subdivision.get('KR-26');
// { code: 'KR-26', name: 'Busan', type: 'Metropolitan city' }
 
subdivision.get('KR-41');
// { code: 'KR-41', name: 'Gyeonggi', type: 'Province' }
 
subdivision.get('KR-49');
// { code: 'KR-49', name: 'Jeju', type: 'Special self-governing province' }

import { subdivision } from '@koshmoney/countries';
 
subdivision.isValidCode('KR-11');     // true (Seoul)
subdivision.isValidCode('KR-41');     // true (Gyeonggi)
subdivision.isValidCode('KR-99');     // false
subdivision.isValidRegion('KR', '26'); // true (Busan)

import { subdivision } from '@koshmoney/countries';
 
const krSubs = subdivision.getByCountry('KR');
 
// Get only provinces
const provinces = krSubs.filter((s) => s.type === 'Province');
console.log(provinces.length); // 9
 
// Get metropolitan cities
const metros = krSubs.filter((s) => s.type === 'Metropolitan city');
console.log(metros.length); // 6

// Import only Korean subdivisions for smaller bundles
import { subdivisions } from '@koshmoney/countries/subdivision/KR';
 
Object.keys(subdivisions);
// ['KR-11', 'KR-26', 'KR-27', ..., 'KR-50']

import { subdivision } from '@koshmoney/countries';
 
type ShippingTier = 'metropolitan' | 'province' | 'island' | 'unknown';
 
function getKoreanShippingTier(subdivisionCode: string): ShippingTier {
  const sub = subdivision.get(subdivisionCode);
  if (!sub) return 'unknown';
 
  // Jeju Island has additional shipping surcharges
  if (subdivisionCode === 'KR-49') return 'island';
 
  if (sub.type === 'Metropolitan city' || sub.type === 'Special city') {
    return 'metropolitan';
  }
 
  return 'province';
}
 
getKoreanShippingTier('KR-11'); // 'metropolitan' (Seoul)
getKoreanShippingTier('KR-41'); // 'province' (Gyeonggi)
getKoreanShippingTier('KR-49'); // 'island' (Jeju - surcharge applies)

import { subdivision } from '@koshmoney/countries';
 
interface KoreanAddress {
  subdivisionCode: string;
  postalCode: string;
  addressLine: string;
}
 
function validateKoreanAddress(address: KoreanAddress): boolean {
  // Validate the subdivision code belongs to South Korea
  const isValidSubdivision =
    subdivision.isValidCode(address.subdivisionCode) &&
    address.subdivisionCode.startsWith('KR-');
 
  // Korean postal codes are 5 digits
  const isValidPostalCode = /^\d{5}$/.test(address.postalCode);
 
  return isValidSubdivision && isValidPostalCode;
}

import { subdivision } from '@koshmoney/countries';
 
// Build options for an address form dropdown
const krProvinceOptions = subdivision
  .getByCountry('KR')
  .map((sub) => ({
    value: sub.code,
    label: sub.name,
    type: sub.type,
  }))
  .sort((a, b) => a.label.localeCompare(b.label));
 
// Group by type for a grouped select element
const grouped = {
  'Special City': krProvinceOptions.filter((o) => o.type === 'Special city'),
  'Metropolitan Cities': krProvinceOptions.filter((o) => o.type === 'Metropolitan city'),
  'Provinces': krProvinceOptions.filter((o) => o.type === 'Province'),
  'Special Autonomous': krProvinceOptions.filter((o) =>
    o.type?.includes('Special') && o.type !== 'Special city'
  ),
};

npm install @koshmoney/countries

import { subdivision } from '@koshmoney/countries';
 
// Validate a Korean province code from user input
function isValidKoreanProvince(code: string): boolean {
  return subdivision.isValidCode(code) && code.startsWith('KR-');
}