South American Countries: Complete List with ISO 3166 Codes

import { geography } from '@koshmoney/countries/geography';
import { country } from '@koshmoney/countries';
 
const southAmericanCodes = geography.getCountriesByContinent('South America');
// ['AR', 'BO', 'BR', 'CL', 'CO', 'EC', 'FK', 'GF', 'GY', 'PE', 'PY', 'SR', 'UY', 'VE']
 
const southAmericanCountries = southAmericanCodes.map((code) => country.whereAlpha2(code));
console.log(southAmericanCountries.length); // 14

import { currency } from '@koshmoney/countries/currency';
 
currency.getCurrency('BR');
// { code: 'BRL', symbol: 'R$', name: 'Brazilian Real' }
 
currency.getCurrency('EC');
// { code: 'USD', symbol: '$', name: 'US Dollar' }
 
// Find all South American countries using the US Dollar
import { geography } from '@koshmoney/countries/geography';
 
const saCodes = geography.getCountriesByContinent('South America');
const usdCountries = saCodes.filter((code) =>
  currency.getCurrencyCode(code) === 'USD'
);
// ['EC']

import { dialCode } from '@koshmoney/countries/dialCode';
 
dialCode.getDialCode('BR'); // '+55'
dialCode.getDialCode('AR'); // '+54'
dialCode.getDialCode('CL'); // '+56'

import { postalCode } from '@koshmoney/countries';
 
postalCode.isValid('BR', '01001-000'); // true
postalCode.isValid('BR', '01001000');  // true
postalCode.getName('BR');              // 'CEP'
postalCode.getFormat('BR');            // 'NNNNN-NNN'

import { geography } from '@koshmoney/countries/geography';
import { country, subdivision, postalCode } from '@koshmoney/countries';
 
const saCodes = geography.getCountriesByContinent('South America');
 
// Build country options for a dropdown
const countryOptions = saCodes
  .map((code) => ({
    value: code,
    label: country.toName(code),
  }))
  .filter((c) => c.label)
  .sort((a, b) => a.label!.localeCompare(b.label!));
 
// Get subdivisions for a selected country
const brazilStates = subdivision.forCountry('BR');
// [{ code: 'BR-AC', name: 'Acre', type: 'State', ... }, ...]
 
const argProvinces = subdivision.forCountry('AR');
// [{ code: 'AR-B', name: 'Buenos Aires', type: 'Province', ... }, ...]

import { country, subdivision, postalCode } from '@koshmoney/countries';
import { geography } from '@koshmoney/countries/geography';
 
function validateSouthAmericanAddress(countryCode: string, state: string, zip: string) {
  // Verify it is a South American country
  if (geography.getContinent(countryCode) !== 'South America') {
    return { valid: false, error: 'Not a South American country' };
  }
 
  // Validate state
  if (state && !subdivision.isValidRegion(countryCode, state)) {
    return { valid: false, error: `Invalid state for ${country.toName(countryCode)}` };
  }
 
  // Validate postal code
  if (zip && postalCode.hasPostalCode(countryCode)) {
    if (!postalCode.isValid(countryCode, zip)) {
      return {
        valid: false,
        error: `Invalid ${postalCode.getName(countryCode)}. Expected: ${postalCode.getFormat(countryCode)}`,
      };
    }
  }
 
  return { valid: true };
}