Skip to main content

Self-contained ISO 3166-1 country definitions.

Project description

Authors: Mike Spindel
Version: 0.2

ISO 3166-1 defines two-letter, three-letter, and three-digit country codes. python-iso3166 is a self-contained module that converts between these codes and the corresponding country name.


$ pip install iso3166


>>> from iso3166 import countries
>>> countries.get('us')
Country(name=u'United States', alpha2='US', alpha3='USA', numeric='840')
>>> countries.get('ala')
Country(name=u'\xc5land Islands', alpha2='AX', alpha3='ALA', numeric='248')
>>> countries.get(8)
Country(name=u'Albania', alpha2='AL', alpha3='ALB', numeric='008')


0.3 - September 4, 2012

  • Current through ISO newsletter VI-13
  • Fix changes from 0.2 (thanks vincentfretin!):
    • Venezuela
    • Saint Helena
    • Bolivia

0.2 - March 26, 2012

  • Current through ISO newsletter VI-12
  • Added missing entry for Afghanistan
  • Updated entries
    • Bolivia (ISO Newsletter VI-6)
    • Libya (VI-11)
    • Saint Helena (VI-7)
    • Sudan (VI-10)
    • Venezuela (VI-5)
  • New entries:
    • Bonaire, Sint Eustatius and Saba (VI-8)
    • Curaçao (VI-8)
    • Sint Maarten (Dutch part) (VI-8)
    • South Sudan (VI-10)
  • Deleted entries:
    • Netherlands Antilles (VI-8)

0.1 - December 14, 2010

  • Initial release

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for iso3166, version 0.3
Filename, size File type Python version Upload date Hashes
Filename, size iso3166-0.3.tar.gz (6.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page