# iso-3166-2

> Lookup information about ISO-3166-2 subdivisions.

Latest version **1.0.0** (published 2017-08-20) · 0 weekly downloads

## Install

```sh
npm install iso-3166-2
pnpm add iso-3166-2
yarn add iso-3166-2
bun add iso-3166-2
```

## Health

**Score 23/100 (F)** — status: abandoned.

Positive: has types package; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.0 |
| Published | 2017-08-20 |
| First published | 2013-03-20 |
| Weekly downloads | 0 |
| TypeScript types | separate (@types/iso-3166-2) |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 114 |
| Author | Ola Holmström |
| Maintainers | olahol |
| Keywords | iso3166, iso-3166, iso-3166-2, geo |

## Links

- npm: https://www.npmjs.com/package/iso-3166-2
- Repository: https://github.com/olahol/iso-3166-2.js
- Homepage: https://github.com/olahol/iso-3166-2.js#readme
- Issues: https://github.com/olahol/iso-3166-2.js/issues
- npm.io page: https://npm.io/package/iso-3166-2

## Recent versions

- 1.0.0 (latest) — 2017-08-20
- 0.6.0 — 2017-04-09
- 0.5.0 — 2017-02-09
- 0.4.0 — 2016-03-28
- 0.3.0 — 2016-03-09
- 0.2.4 — 2016-01-18
- 0.2.3 — 2015-11-17
- 0.2.2 — 2015-11-07
- 0.2.1 — 2014-04-03
- 0.2.0 — 2014-04-02
- 0.1.1 — 2013-03-22
- 0.1.0 — 2013-03-20

## README

# iso-3166-2.js

[![NPM version][npm-image]][npm-url]
[![Build Status][travis-image]][travis-url]
[![Download Count][downloads-image]][downloads-url]

> Lookup information about ISO-3166-2 subdivisions.

## Country code format

The country codes in the data are in the ISO 3166-1 alpha 2 format (US,
SE ...), but there is a conversion table that makes possible to input
alpha 3 codes (USA, SWE ...) to the `subdivision` and `country` functions.

https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2

https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3

## Examples

```js
> iso3166.subdivision("SE-O");

{ type: 'County',
  name: 'Västra Götalands län',
  countryName: 'Sweden',
  countryCode: 'SE',
  regionCode: 'O',
  code: 'SE-O' }
```

```js
> iso3166.subdivision("UN-1");
null
```

```js
> iso3166.subdivision("SE", "O");

{ type: 'County',
  name: 'Västra Götalands län',
  countryName: 'Sweden',
  countryCode: 'SE',
  regionCode: 'O',
  code: 'SE-O' }
```

```js
> iso3166.subdivision("USA", "Indiana");

{ type: 'state',
  name: 'Indiana',
  countryName: 'United States',
  countryCode: 'US',
  regionCode: 'IN',
  code: 'US-IN' }
```

```js
> iso3166.country("Sweden");
{ name: 'Sweden',
  sub:
   { 'SE-O': { type: 'County', name: 'Västra Götalands län' },
     'SE-N': { type: 'County', name: 'Hallands län' },
     'SE-M': { type: 'County', name: 'Skåne län' },
     'SE-K': { type: 'County', name: 'Blekinge län' },
     'SE-I': { type: 'County', name: 'Gotlands län' },
     'SE-H': { type: 'County', name: 'Kalmar län' },
     'SE-G': { type: 'County', name: 'Kronobergs län' },
     'SE-F': { type: 'County', name: 'Jönköpings län' },
     'SE-E': { type: 'County', name: 'Östergötlands län' },
     'SE-D': { type: 'County', name: 'Södermanlands län' },
     'SE-C': { type: 'County', name: 'Uppsala län' },
     'SE-W': { type: 'County', name: 'Dalarnas län' },
     'SE-Z': { type: 'County', name: 'Jämtlands län' },
     'SE-Y': { type: 'County', name: 'Västernorrlands län' },
     'SE-X': { type: 'County', name: 'Gävleborgs län' },
     'SE-AC': { type: 'County', name: 'Västerbottens län' },
     'SE-AB': { type: 'County', name: 'Stockholms län' },
     'SE-BD': { type: 'County', name: 'Norrbottens län' },
     'SE-T': { type: 'County', name: 'Örebro län' },
     'SE-S': { type: 'County', name: 'Värmlands län' },
     'SE-U': { type: 'County', name: 'Västmanlands län' } },
  code: 'SE' }
```

```js
> iso3166.country("United Nations");
null
```

## Functions

### iso3166.subdivision(code)
Retrieves a subdivision by its full code, ex "SE-O", "US-IN". Returns
`null` if not found.

* * *

### iso3166.subdivision(country code, subdivision code)
Retrieves a subdivision by its country code and subdivision code, ex
("SWE", "O"). Returns `null` if not found.

* * *

### iso3166.subdivision(country code, subdivision name)
Retrieves a subdivision by its country code and subdivision name, ex
("US", "Indiana"). Returns `null` if not found.

* * *

### iso3166.country(country code)
Retrieves a country by its code, ex "US", "SE", "SWE". Returns `null`
if not found.

* * *

### iso3166.country(country name)
Retrieves a country by its name, ex "United States", "Sweden". Returns
`null` if not found.

* * *

### iso3166.data

The raw ISO 3166-2 data, the layout is:

```js
{
  country code (alpha 2): {
    name: country name, ex Sweden, United States ...
    sub: {
      subdivision code: {
        type: subdivision type, ex county, divison ...
        name: subdivision name, ex Västra Götaland, Indiana
      }
    }
  }
}
```

* * *

### iso3166.codes

The ISO 3166-1 alpha 3 to alpha 2 conversion table, the layout is:

```js
{
  country code (alpha 3): country code (alpha 2)
}
```

## Contributors

* Ola Holmström (@olahol)
* Ben Ilegbodu (@benmvp)
* David García (@davidgf)
* lhchavez (@lhchavez)
* Peter Pinch (@pdpinch)

[npm-image]: https://img.shields.io/npm/v/iso-3166-2.svg?style=flat-square
[npm-url]: https://npmjs.org/package/iso-3166-2
[downloads-image]: http://img.shields.io/npm/dm/iso-3166-2.svg?style=flat-square
[downloads-url]: https://npmjs.org/package/iso-3166-2
[travis-image]: https://img.shields.io/travis/olahol/iso-3166-2.js/master.svg?style=flat-square
[travis-url]: https://travis-ci.org/olahol/iso-3166-2.js

---
_Source: https://npm.io/package/iso-3166-2 · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._