Skip to content

0.3.0

Choose a tag to compare

View all tags
@andrekutianski andrekutianski released this 28 Oct 05:07
· 7 commits to master since this release
0.3.0
f739220

🌍 n8n Country State City v0.3.0 - ISO3 Support

What's New

🆕 ISO3 Country Code Support

NEW OPERATION: "Get Country by ISO3 Code" - Now supports 3-letter country codes!

Perfect for integrations that use ISO3 format (USA, BRA, CAN, GBR, etc.)

Key Features:

  • 🗺️ Complete mapping: All 249 countries supported
  • 🔄 Automatic conversion: ISO3 → ISO2 → country data
  • 📊 Enhanced response: Includes both ISO2 and ISO3 codes
  • ⚡ Fast lookup: Instant conversion with comprehensive validation

🌎 Code Examples

Popular Countries

Country ISO2 ISO3 Usage
🇺🇸 United States US USA getCountryByISO3Code: "USA"
🇧🇷 Brazil BR BRA getCountryByISO3Code: "BRA"
🇨🇦 Canada CA CAN getCountryByISO3Code: "CAN"
🇬🇧 United Kingdom GB GBR getCountryByISO3Code: "GBR"
🇫🇷 France FR FRA getCountryByISO3Code: "FRA"
🇩🇪 Germany DE DEU getCountryByISO3Code: "DEU"

📋 Complete Operations List

  1. Get Country by Code - ISO2 format (US, BR, CA)
  2. 🆕 Get Country by ISO3 Code - ISO3 format (USA, BRA, CAN)
  3. Get States by Country - All states/provinces
  4. Get State by Code - Specific state details
  5. Get Cities by State - All cities in a state

🎯 When to Use Each Format

Use ISO2 (2 letters)

  • ✅ All existing operations (states, cities)
  • ✅ Most APIs and databases
  • ✅ Compact storage

Use ISO3 (3 letters)

  • ✅ International standards compliance
  • ✅ Better readability (USA vs US)
  • ✅ Legacy system integration

💡 Enhanced Features

Improved User Experience

  • Clear field labels: Distinguishes ISO2 vs ISO3 inputs
  • Better descriptions: Each operation clearly labeled
  • Smart validation: Helpful error messages for invalid codes

Technical Improvements

  • Comprehensive mapping: iso-mappings.ts with all countries
  • Input validation: Proper error handling for invalid ISO3 codes
  • Extended interface: Supports both code formats seamlessly

📦 Installation

npm install n8n-nodes-country-state-city@0.3.0

🔗 Migration Guide

From v0.2.0 to v0.3.0: No breaking changes! All existing workflows continue to work.

New capability: You can now use either ISO2 or ISO3 codes for country lookups.

What's Changed

  • feat: Add ISO3 country code support with comprehensive mapping
  • docs: Update changelog and README for v0.3.0 ISO3 support
  • technical: Create iso-mappings.ts with complete ISO2 ↔ ISO3 mappings

Full Changelog: v0.2.0...v0.3.0

🙏 Community

This release addresses community requests for ISO3 support while maintaining full backward compatibility with existing workflows.

Try it now: Test the new ISO3 operation with codes like USA, BRA, CAN! 🚀

Assets 2
Loading