Skip to content

Countries

FtM's model of political geography is an evolving part of the toolkit. After first modeling UN member states as countries, the supported codelist quickly grew to include contested territories and breakaway regions for practical reasons. Referencing controversial places is a key feature of FtM data.

The model has now matured to distinguish several concepts:

  • Territories are units of political geography. They can overlap or contradict each other in terms of the physical space they occupy. As long as someone claims to hold political power in a place, this can be reason for FtM to model it.
  • Jurisdictions are territories which impose their own legal regime, often with regards to the formation of companies. Most countries are jurisdictions, but some countries are subdivided into smaller jurisdictions - think Dubai as part of the UAE, Delaware as part of the US.
  • Countries are UN member states. Beyond that, certain territories are countries in practice (think Kosovo). To go with the old adage: A country is a territory with an army and a navy.
Attribute Value Detail
name country Used in schema definitions
label Country plural: Countries
group countries Used in search indexing to query all properties of a given type
matchable Suitable for use in entity matching
pivot Suitable for use as a pivot point for connecting to other entities

Territories

This table lists the full set of geographic territories described in rigour. A subset of them are currently supported as property values in FtM, with the rest being mapped to existing country codes as stated here. This table is the return value of rigour.territories.get_territories. The returned objects also provides alternate codes and Wikidata QIDs for some territories, expanding the ability to interpret data from a wide range of sources.

Code Label FtM Country Jurisdiction Historical Wikidata
ac Ascension Island ac Q46197
ad Andorra ad Q228
ae United Arab Emirates ae Q878
ae-aj ‘Ajmān ae Q159477
ae-az Abu Dhabi ae Q187712
ae-du Dubai ae Q613
ae-fu Fujairah ae Q4045
ae-rk Ras Al Khaimah ae Q170024
ae-sh Sharjah ae Q289693
ae-uq Umm Al Quwain ae Q175021
af Afghanistan af Q889
ag Antigua and Barbuda ag Q781
ai Anguilla ai Q25228
al Albania al Q222
am Armenia am Q399
an Netherlands Antilles nl Q25227
ao Angola ao Q916
aq Antarctica aq Q51
ar Argentina ar Q414
as American Samoa as Q16641
at Austria at Q40
au Australia au Q408
aw Aruba aw Q21203
ax Åland Islands ax Q5689
az Azerbaijan az Q227
az-nk Artsakh az-nk Q244165
ba Bosnia and Herzegovina ba Q225
ba-bih Federation of Bosnia and Herzegovina ba Q11198
ba-brk Brčko District ba Q194483
ba-srp Republika Srpska ba Q11196
bb Barbados bb Q244
bd Bangladesh bd Q902
be Belgium be Q31
be-vlg Flanders be Q9337
bf Burkina Faso bf Q965
bg Bulgaria bg Q219
bh Bahrain bh Q398
bi Burundi bi Q967
bj Benin bj Q962
bl Saint Barthélemy bl Q25362
bm Bermuda bm Q23635
bn Brunei bn Q921
bo Bolivia bo Q750
bq Bonaire, Sint Eustatius and Saba bq Q27561
br Brazil br Q155
bs Bahamas bs Q778
bt Bhutan bt Q917
bv Bouvet Island bv Q23408
bw Botswana bw Q963
by Belarus by Q184
bz Belize bz Q242
ca Canada ca Q16
ca-ab Alberta ca Q1951
ca-bc British Columbia ca Q1973
ca-mb Manitoba ca Q1948
ca-nb New Brunswick ca Q1965
ca-nl Newfoundland and Labrador ca Q2003
ca-ns Nova Scotia ca Q1952
ca-nt Northwest Territories ca Q2007
ca-nu Nunavut ca Q2023
ca-on Ontario ca Q1904
ca-pe Prince Edward Island ca Q1978
ca-qc Quebec ca Q176
ca-sk Saskatchewan ca Q1989
ca-yt Yukon ca Q2009
cc Cocos (Keeling) Islands cc Q36004
cd DR Congo cd Q974
cf Central African Republic cf Q929
cg Congo-Brazzaville cg Q971
ch Switzerland ch Q39
ch-ag Aargau ch Q11972
ch-ai Appenzell Innerrhoden ch Q12094
ch-ar Appenzell Ausserrhoden ch Q12079
ch-be Bern ch Q11911
ch-bl Basel-Landschaft ch Q12146
ch-bs Basel-Stadt ch Q12172
ch-fr Fribourg ch Q12640
ch-ge Geneva ch Q11917
ch-gl Glarus ch Q11922
ch-gr Grisons ch Q11925
ch-ju Jura ch Q12755
ch-lu Lucerne ch Q12121
ch-ne Neuchâtel ch Q12738
ch-nw Nidwalden ch Q12592
ch-ow Obwalden ch Q12573
ch-sg St. Gallen ch Q12746
ch-sh Schaffhausen ch Q12697
ch-so Solothurn ch Q11929
ch-sz Schwyz ch Q12433
ch-tg Thurgau ch Q12713
ch-ti Ticino ch Q12724
ch-ur Uri ch Q12404
ch-vd Vaud ch Q12771
ch-vs Valais ch Q834
ch-zg Zug ch Q11933
ch-zh Zürich ch Q11943
ci Côte d'Ivoire ci Q1008
ck Cook Islands ck Q26988
cl Chile cl Q298
cm Cameroon cm Q1009
cn China cn Q148
cn-ah Anhui cn Q40956
cn-fj Fujian cn Q41705
cn-gd Guangdong cn Q15175
cn-gs Gansu cn Q42392
cn-gz Guizhou cn Q47097
cn-ha Henan cn Q43684
cn-hb Hubei cn Q46862
cn-he Hebei cn Q21208
cn-hi Hainan cn Q42200
cn-hl Heilongjiang cn Q19206
cn-hn Hunan cn Q45761
cn-jl Jilin cn Q45208
cn-js Jiangsu cn Q16963
cn-jx Jiangxi cn Q57052
cn-ln Liaoning cn Q43934
cn-qh Qinghai cn Q45833
cn-sc Sichuan cn Q19770
cn-sd Shandong cn Q43407
cn-sn Shaanxi cn Q47974
cn-sx Shanxi cn Q46913
cn-xj Xinjiang cn Q34800
cn-xz Tibet cn-xz Q17252
cn-yn Yunnan cn Q43194
cn-zj Zhejiang cn Q16967
co Colombia co Q739
cp Clipperton Island cp Q161258
cq Sark cq Q3405693
cr Costa Rica cr Q800
cshh Czechoslovakia cshh Q33946
csxx Serbia and Montenegro csxx Q37024
cu Cuba cu Q241
cv Cape Verde cv Q1011
cw Curaçao cw Q25279
cx Christmas Island cx Q31063
cy Cyprus cy Q229
cy-trnc Northern Cyprus cy-trnc Q23681
cz Czechia cz Q213
dd East Germany dd Q16957
de Germany de Q183
dg Diego Garcia dg Q184851
dj Djibouti dj Q977
dk Denmark dk Q756617
dm Dominica dm Q784
do Dominican Republic do Q786
dz Algeria dz Q262
ec Ecuador ec Q736
ee Estonia ee Q191
eg Egypt eg Q79
eh Western Sahara eh Q40362
er Eritrea er Q986
es Spain es Q29
et Ethiopia et Q115
eu European Union eu Q458
fi Finland fi Q33
fj Fiji fj Q712
fk Falkland Islands fk Q9648
fm Micronesia fm Q702
fo Faroe Islands fo Q4628
fr France fr Q142
ga Gabon ga Q1000
gb United Kingdom gb Q145
gb-nir Northern Ireland gb-nir Q26
gb-sct Scotland gb-sct Q22
gb-wls Wales gb-wls Q25
gd Grenada gd Q769
ge Georgia ge Q230
ge-ab Abkhazia (Occupied Georgia) ge-ab Q31354462
gf French Guiana gf Q3769
gg Guernsey gg Q25230
gh Ghana gh Q117
gi Gibraltar gi Q1410
gl Greenland gl Q223
gm Gambia gm Q1005
gn Guinea gn Q1006
gp Guadeloupe gp Q17012
gq Equatorial Guinea gq Q983
gr Greece gr Q41
gs South Georgia and the South Sandwich Islands gs Q35086
gt Guatemala gt Q774
gu Guam gu Q16635
gw Guinea-Bissau gw Q1007
gy Guyana gy Q734
hk Hong Kong SAR hk Q8646
hm Heard and McDonald Islands hm Q131198
hn Honduras hn Q783
hr Croatia hr Q224
ht Haiti ht Q790
hu Hungary hu Q28
ic Canary Islands ic Q5813
id Indonesia id Q252
ie Ireland ie Q27
il Israel il Q801
im Isle of Man im Q9676
in India in Q668
in-ap Andhra Pradesh in Q1159
in-ar Arunachal Pradesh in Q1162
in-as Assam in Q1164
in-br Bihar in Q1165
in-cg Chhattisgarh in Q1168
in-ga Goa in Q1171
in-gj Gujarat in Q1061
in-hp Himachal Pradesh in Q1177
in-hr Haryana in Q1174
in-jh Jharkhand in Q1184
in-ka Karnataka in Q1185
in-kl Kerala in Q1186
in-mh Maharashtra in Q1191
in-ml Meghalaya in Q1195
in-mn Manipur in Q1193
in-mp Madhya Pradesh in Q1188
in-mz Mizoram in Q1502
in-nl Nagaland in Q1599
in-od Odisha in Q22048
in-pb Punjab in Q22424
in-rj Rajasthan in Q1437
in-sk Sikkim in Q1505
in-tn Tamil Nadu in Q1445
in-tr Tripura in Q1363
in-ts Telangana in Q677037
in-uk Uttarakhand in Q1499
in-up Uttar Pradesh in Q1498
in-wb West Bengal in Q1356
io British Indian Ocean Territory io Q43448
iq Iraq iq Q796
iq-kr Kurdistan iq-kr Q41470
ir Iran ir Q794
is Iceland is Q189
it Italy it Q38
je Jersey je Q785
jm Jamaica jm Q766
jo Jordan jo Q810
jp Japan jp Q17
ke Kenya ke Q114
kg Kyrgyzstan kg Q813
kh Cambodia kh Q424
ki Kiribati ki Q710
km Comoros km Q970
kn Saint Kitts and Nevis kn Q763
kn-n Nevis (Saint Kitts and Nevis) kn Q207794
kp North Korea kp Q423
kr South Korea kr Q884
kw Kuwait kw Q817
ky Cayman Islands ky Q5785
kz Kazakhstan kz Q232
la Laos la Q819
lb Lebanon lb Q822
lc Saint Lucia lc Q760
li Liechtenstein li Q347
lk Sri Lanka lk Q854
lr Liberia lr Q1014
ls Lesotho ls Q1013
lt Lithuania lt Q37
lu Luxembourg lu Q32
lv Latvia lv Q211
ly Libya ly Q1016
ma Morocco ma Q1028
mc Monaco mc Q235
md Moldova md Q217
md-pmr Transnistria (PMR) md-pmr Q907112
me Montenegro me Q236
mf Saint Martin mf Q126125
mg Madagascar mg Q1019
mh Marshall Islands mh Q709
mk North Macedonia mk Q221
ml Mali ml Q912
mm Myanmar mm Q836
mn Mongolia mn Q711
mo Macao SAR mo Q14773
mp Northern Mariana Islands mp Q16644
mq Martinique mq Q17054
mr Mauritania mr Q1025
ms Montserrat ms Q13353
mt Malta mt Q233
mu Mauritius mu Q1027
mv Maldives mv Q826
mw Malawi mw Q1020
mx Mexico mx Q96
my Malaysia my Q833
my-15 Labuan my Q214504
mz Mozambique mz Q1029
na Namibia na Q1030
nc New Caledonia nc Q33788
ne Niger ne Q1032
nf Norfolk Island nf Q31057
ng Nigeria ng Q1033
ni Nicaragua ni Q811
nl Netherlands nl Q29999
no Norway no Q20
np Nepal np Q837
nr Nauru nr Q697
nu Niue nu Q34020
nz New Zealand nz Q664
om Oman om Q842
pa Panama pa Q804
pe Peru pe Q419
pf French Polynesia pf Q30971
pg Papua New Guinea pg Q691
ph Philippines ph Q928
pk Pakistan pk Q843
pk-km Kashmir pk-km Q43100
pl Poland pl Q36
pm Saint Pierre and Miquelon pm Q34617
pn Pitcairn pn Q35672
pr Puerto Rico pr Q1183
ps Palestinian territories ps Q219060
pt Portugal pt Q45
pt-20 Azores pt Q25263
pt-30 Madeira pt Q26253
pw Palau pw Q695
py Paraguay py Q733
qa Qatar qa Q846
re Réunion re Q17070
ro Romania ro Q218
rs Serbia rs Q403
ru Russia ru Q159
ru-ad Adygea ru Q3734
ru-al Altai Republic ru Q5971
ru-alt Altai Krai ru Q5942
ru-amu Amur Oblast ru Q6886
ru-ark Arkhangelsk Oblast ru Q1875
ru-ast Astrakhan Oblast ru Q3941
ru-ba Bashkortostan ru Q5710
ru-bel Belgorod Oblast ru Q3329
ru-bry Bryansk Oblast ru Q2810
ru-bu Buryatia ru Q6809
ru-ce Chechnya ru Q5187
ru-che Chelyabinsk Oblast ru Q5714
ru-chu Chukotka Autonomous Okrug ru Q7984
ru-cu Chuvashia ru Q5466
ru-da Dagestan ru Q5118
ru-in Ingushetia ru Q5219
ru-irk Irkutsk Oblast ru Q6585
ru-iva Ivanovo Oblast ru Q2654
ru-kam Kamchatka Krai ru Q7948
ru-kb Kabardino-Balkaria ru Q5267
ru-kc Karachay-Cherkessia ru Q5328
ru-kda Krasnodar Krai ru Q3680
ru-kem Kemerovo Oblast ru Q6076
ru-kgd Kaliningrad Oblast ru Q1749
ru-kgn Kurgan Oblast ru Q5741
ru-kha Khabarovsk Krai ru Q7788
ru-khm Khanty-Mansi Autonomous Okrug ru Q6320
ru-kir Kirov Oblast ru Q5387
ru-kk Khakassia ru Q6543
ru-kl Kalmykia ru Q3953
ru-klu Kaluga Oblast ru Q2842
ru-ko Komi Republic ru Q2073
ru-kos Kostroma Oblast ru Q2596
ru-kr Karelia ru Q1914
ru-krs Kursk Oblast ru Q3178
ru-kya Krasnoyarsk Krai ru Q6563
ru-len Leningrad Oblast ru Q2191
ru-lip Lipetsk Oblast ru Q3510
ru-mag Magadan Oblast ru Q7971
ru-me Mari El ru Q5446
ru-mo Mordovia ru Q5340
ru-mos Moscow Oblast ru Q1697
ru-mow Moscow ru Q649
ru-mur Murmansk Oblast ru Q1759
ru-nen Nenets Autonomous Okrug ru Q2164
ru-ngr Novgorod Oblast ru Q2240
ru-niz Nizhny Novgorod Oblast ru Q2246
ru-nvs Novosibirsk Oblast ru Q5851
ru-oms Omsk Oblast ru Q5835
ru-ore Orenburg Oblast ru Q5338
ru-orl Oryol Oblast ru Q3129
ru-per Perm Krai ru Q5400
ru-pnz Penza Oblast ru Q5545
ru-pri Primorsky Krai ru Q4341
ru-psk Pskov Oblast ru Q2218
ru-ros Rostov Oblast ru Q3573
ru-rya Ryazan Oblast ru Q2753
ru-sa Sakha ru Q6605
ru-sak Sakhalin Oblast ru Q7797
ru-sam Samara Oblast ru Q1727
ru-sar Saratov Oblast ru Q5334
ru-se North Ossetia–Alania ru Q5237
ru-smo Smolensk Oblast ru Q2347
ru-spe Saint Petersburg ru Q656
ru-sta Stavropol Krai ru Q5207
ru-sve Sverdlovsk Oblast ru Q5462
ru-ta Tatarstan ru Q5481
ru-tam Tambov Oblast ru Q3550
ru-tom Tomsk Oblast ru Q5884
ru-tul Tula Oblast ru Q2792
ru-tve Tver Oblast ru Q2292
ru-ty Tuva ru Q960
ru-tyu Tyumen Oblast ru Q5824
ru-ud Udmurtia ru Q5422
ru-uly Ulyanovsk Oblast ru Q5634
ru-vgg Volgograd Oblast ru Q3819
ru-vla Vladimir Oblast ru Q2702
ru-vlg Vologda Oblast ru Q2015
ru-vor Voronezh Oblast ru Q3447
ru-yan Yamalo-Nenets Autonomous Okrug ru Q6407
ru-yar Yaroslavl Oblast ru Q2448
ru-yev Jewish Autonomous Oblast ru Q7730
ru-zab Zabaykalsky Krai ru Q6838
rw Rwanda rw Q1037
sa Saudi Arabia sa Q851
sb Solomon Islands sb Q685
sc Seychelles sc Q1042
sd Sudan sd Q1049
se Sweden se Q34
sg Singapore sg Q334
sh Saint Helena, Ascension and Tristan da Cunha sh Q192184
sh-hl Saint Helena sh Q34497
si Slovenia si Q215
sj Svalbard and Jan Mayen sj Q25231
sk Slovakia sk Q214
sl Sierra Leone sl Q1044
sm San Marino sm Q238
sn Senegal sn Q1041
so Somalia so Q1045
so-som Somaliland so-som Q34754
sr Suriname sr Q730
ss South Sudan ss Q958
st São Tomé and Príncipe st Q1039
su-am Armenian SSR suhh Q132856
su-az Azerbaijan SSR suhh Q131337
su-by Byelorussian SSR suhh Q2895
su-ee Estonian SSR suhh Q130280
su-ge Georgian SSR suhh Q130229
su-kg Kirghiz SSR suhh Q130276
su-kz Kazakh SSR suhh Q168811
su-lt Lithuanian SSR suhh Q173761
su-lv Latvian SSR suhh Q192180
su-md Moldavian SSR suhh Q170895
su-ru Russian SSR suhh Q2184
su-tj Tajik SSR suhh Q199711
su-tm Turkmen SSR suhh Q199707
su-ua Ukrainian SSR suhh Q133356
suhh Soviet Union suhh Q15180
sv El Salvador sv Q792
sx Sint Maarten sx Q26273
sy Syria sy Q858
sz Eswatini sz Q1050
ta Tristan da Cunha ta Q220982
tc Turks and Caicos Islands tc Q18221
td Chad td Q657
tf French Southern Territories tf Q129003
tg Togo tg Q945
th Thailand th Q869
tj Tajikistan tj Q863
tk Tokelau tk Q36823
tl Timor-Leste tl Q574
tm Turkmenistan tm Q874
tn Tunisia tn Q948
to Tonga to Q678
tr Türkiye tr Q43
tt Trinidad and Tobago tt Q754
tv Tuvalu tv Q672
tw Taiwan tw Q865
tz Tanzania tz Q924
ua Ukraine ua Q212
ua-cri Crimea (Occupied Ukraine) ua-cri Q15925436
ua-dpr Donetsk (Occupied Ukraine) ua-dpr Q16150196
ua-lpr Luhansk (Occupied Ukraine) ua-lpr Q16746854
ug Uganda ug Q1036
um U.S. Outlying Islands um Q16645
un United Nations un Q1065
us United States of America us Q30
us-ak Alaska us Q797
us-al Alabama us Q173
us-ar Arkansas us Q1612
us-az Arizona us Q816
us-ca California us Q99
us-co Colorado us Q1261
us-ct Connecticut us Q779
us-dc District of Columbia us Q3551781
us-de Delaware us Q1393
us-fl Florida us Q812
us-ga Georgia us Q1428
us-hi Hawaii us Q782
us-ia Iowa us Q1546
us-id Idaho us Q1221
us-il Illinois us Q1204
us-in Indiana us Q1415
us-ks Kansas us Q1558
us-ky Kentucky us Q1603
us-la Louisiana us Q1588
us-ma Massachusetts us Q771
us-md Maryland us Q1391
us-me Maine us Q724
us-mi Michigan us Q1166
us-mn Minnesota us Q1527
us-mo Missouri us Q1581
us-ms Mississippi us Q1494
us-mt Montana us Q1212
us-nc North Carolina us Q1454
us-nd North Dakota us Q1207
us-ne Nebraska us Q1553
us-nh New Hampshire us Q759
us-nj New Jersey us Q1408
us-nm New Mexico us Q1522
us-nv Nevada us Q1227
us-ny New York us Q1384
us-oh Ohio us Q1397
us-ok Oklahoma us Q1649
us-or Oregon us Q824
us-pa Pennsylvania us Q1400
us-ri Rhode Island us Q1387
us-sc South Carolina us Q1456
us-sd South Dakota us Q1211
us-tn Tennessee us Q1509
us-tx Texas us Q1439
us-ut Utah us Q829
us-va Virginia us Q1370
us-vt Vermont us Q16551
us-wa Washington us Q1223
us-wi Wisconsin us Q1537
us-wv West Virginia us Q1371
us-wy Wyoming us Q1214
uy Uruguay uy Q77
uz Uzbekistan uz Q265
va Holy See va Q237
vc Saint Vincent and the Grenadines vc Q757
ve Venezuela ve Q717
vg British Virgin Islands vg Q25305
vi U.S. Virgin Islands vi Q11703
vn Vietnam vn Q881
vu Vanuatu vu Q686
wf Wallis and Futuna wf Q35555
ws Samoa ws Q683
x-so South Ossetia (Occupied Georgia) x-so Q23427
xk Kosovo xk Q1246
ye Yemen ye Q805
yt Mayotte yt Q17063
yucs Yugoslavia yucs Q83286
za South Africa za Q258
zm Zambia zm Q953
zr Zaire zr Q6500954
zw Zimbabwe zw Q954
zz Global zz Q2

followthemoney.types.CountryType

Bases: EnumType

Properties to define countries and territories. This is completely descriptive and needs to deal with data from many origins, so we support a number of unusual and controversial designations (e.g. the Soviet Union, Transnistria, Somaliland, Kosovo).

Source code in followthemoney/types/country.py
class CountryType(EnumType):
    """Properties to define countries and territories. This is completely
    descriptive and needs to deal with data from many origins, so we support
    a number of unusual and controversial designations (e.g. the Soviet Union,
    Transnistria, Somaliland, Kosovo)."""

    name = const("country")
    group = const("countries")
    label = _("Country")
    plural = _("Countries")
    matchable = True
    max_length = 16

    def _locale_names(self, locale: Locale) -> EnumValues:
        return {t.code: t.name for t in get_ftm_countries()}

    def clean_text(
        self,
        text: str,
        fuzzy: bool = False,
        format: Optional[str] = None,
        proxy: Optional["EntityProxy"] = None,
    ) -> Optional[str]:
        """Determine a two-letter country code based on an input.

        The input may be a country code, a country name, etc.
        """
        territory = get_territory(text)
        if territory is not None:
            ftm_country = territory.ftm_country
            if ftm_country is not None:
                return ftm_country
        code = countrynames.to_code(text, fuzzy=fuzzy)
        if code is not None:
            territory = get_territory(code)
            if territory is not None:
                return territory.ftm_country
        return None

    def country_hint(self, value: str) -> str:
        return value

clean_text(text, fuzzy=False, format=None, proxy=None)

Determine a two-letter country code based on an input.

The input may be a country code, a country name, etc.

Source code in followthemoney/types/country.py
def clean_text(
    self,
    text: str,
    fuzzy: bool = False,
    format: Optional[str] = None,
    proxy: Optional["EntityProxy"] = None,
) -> Optional[str]:
    """Determine a two-letter country code based on an input.

    The input may be a country code, a country name, etc.
    """
    territory = get_territory(text)
    if territory is not None:
        ftm_country = territory.ftm_country
        if ftm_country is not None:
            return ftm_country
    code = countrynames.to_code(text, fuzzy=fuzzy)
    if code is not None:
        territory = get_territory(code)
        if territory is not None:
            return territory.ftm_country
    return None