ISO 3166 Updates API
ISO 3166 Updates API — Access all of the current and historical ISO 3166 chang
ISO 3166 Updates API exposes access all of the current and historical ISO 3166 changes data We verified a keyless GET endpoint returning JSON (Geocoding). Check the provider docs for rate limits and terms before production use.
We probe a documented GET and expect 2xx JSON — full uptime and health score. Open provider docs ↗
On our probe schedule. Uptime charts appear after the first check lands.
GET https://iso3166-updates.vercel.app/api/all
{
"data": {
"AD": [
{
"Change": "Update List Source.",
"Date Issued": "2015-11-27",
"Description of Change": "",
"Source": "Online Browsing Platform (OBP) - https://www.iso.org/obp/ui/#iso:code:3166:AD."
},
{
"Change": "Update List Source.",
"Date Issued": "2014-11-03",
"Description of Change": "",
"Source": "Online Browsing Platform (OBP) - https://www.iso.org/obp/ui/#iso:code:3166:AD."
}
],
"AE": [
{
"Change": "Change of spelling of AE-AJ, AE-RK; addition of local variation of AE-FU, AE-RK, AE-UQ; update List Source.",
"Date Issued": "2015-11-27",
"Description of Change": "",
"Source": "Online Browsing Platform (OBP) - https://www.iso.org/obp/ui/#iso:code:3166:AE."
},
{
"Change": "Error correction: Spelling correction in AE-AZ.",
"Date Issued": "2002-08-20",
"Description of Change": "",
"Source": "Newsletter I-3 - https://web.archive.org/web/20081218103236/http://www.iso.org/iso/iso_3166-2_newsletter_i-3_en.pdf."
}
],
"AF": [
{
"Change": "Correction of the Code Source.",
"Date Issued": "2020-11-24",
"Description of Change": "",
"Source": "Online Browsing Platform (OBP) - https://www.iso.org/obp/ui/#iso:code:3166:AF."
},
{
"Change": "Correction of the romanization system label.",
"Date Issued": "2018-11-26",
"Description of Change": "",
"Source": "Online Browsing Platform (OBP) - https://www.iso.org/obp/ui/#iso:code:3166:AF."
}
],
"AG": [
{
"Change": "Change spelling of AG-04.",
"Date Issued": "2014-10-29",
"Description of Change": "",
"Source": "Online Browsing Platform (OBP) - https://www.iso.org/obp/ui/#iso:code:3166:AG."
},
{
"Change": "Subdivisions added: AG-11 Redonda.",
"Date Issued": "2010-06-30",
"Description of Change": "Update of the administrative structure and of the list source.",
"Source": "Newsletter II-2 - https://www.iso.org/files/live/sites/isoorg/files/archive/pdf/en/iso_3166-2_newsletter_ii-2_2010-06-30.pdf."
}
],
"AI": [
{
"Change": "Modification of remark part 2. (Remark part 2: No subdivisions relevant for this standard).",
"Date Issued": "2018-11-26",
"Description of Change": "",
"Source": "Online Browsing Platform (OBP) - https://www.iso.org/obp/ui/#iso:code:3166:AI."
}
],
"AL": [
{
"Change": "Correction of the Code Source.",
"Date Issued": "2020-11-24",
"Description of Change": "",
"Source": "Online Browsing Platform (OBP) - https://www.iso.org/obp/ui/#iso:code:3166:AL."
},
{
"Change": "Change of subdivision category from préfecture to comté in French; deletion of all districts; update List Source.",
"Date Issued": "2015-11-27",
"Description of Change": "",
"Source": "Online Browsing Platform (OBP) - https://www.iso.org/obp/ui/#iso:code:3166:AL."
}
],
"AM": [
{
"Change": "Correction of the romanization system label.",
"Date Issued": "2018-11-26",
"Description of Change": "",
"Source": "Online Browsing Platform (OBP) - https://www.iso.org/obp/ui/#iso:code:3166:AM."
}
],
"AO": [
{
"Change": "Change of spelling of AO-CCU, AO-CNO, AO-CUS, AO-LNO, AO-LSU; Addition of local variation for AO-CCU, AO-CNO, AO-CUS; Update List Source.",
"Date Issued": "2020-11-24",
"Description of Change": "",
"Source": "Online Browsing Platform (OBP) - https://www.iso.org/obp/ui/#iso:code:3166:AO."
},
{
"Change": "Update List Source.",
"Date Issued": "2015-11-27",
"Description of Change": "",
"Source": "Online Browsing Platform (OBP) - https://www.iso.org/obp/ui/#iso:code:3166:AO."
}
]
},
"metadata": {
"count": 911,
"generated": "2026-07-05T17:35:25Z"
}
}curl "https://iso3166-updates.vercel.app/api/all"const res = await fetch("https://iso3166-updates.vercel.app/api/all");
const data = await res.json();
console.log(data);import requests
res = requests.get("https://iso3166-updates.vercel.app/api/all")
print(res.json())/api/allPROBEDISO 3166 Updates API — Access all of the current and historical ISO 3166 chang
/apiApi — documented GET route.
/api/1Api details by ID (example: 1).
/api?limit=10Api — documented GET route.
/api/search?q=testSearch by query parameters.
/api/alpha/%7Binput_alpha%7D%7Binput Alpha%7D — documented GET route.
We probe a documented GET and expect 2xx JSON — full uptime and health score. Export includes every documented route below.
Not tracked yet. Shape-change history starts once this API joins our probe schedule.
ISO 3166 Updates API: common questions
Is ISO 3166 Updates API free to use?
Yes — ISO 3166 Updates API is a free geo & maps API. Free tier: Free — limits not published. Whether the free tier allows commercial use is unclear — check the provider docs.
Does ISO 3166 Updates API need an API key?
No — ISO 3166 Updates API needs no API key or signup. You can call it straight away; rate limits still apply (Unpublished).
Can I call ISO 3166 Updates API from the browser?
Yes — ISO 3166 Updates API returns CORS headers over HTTPS, so front-end code can fetch it directly with no backend proxy. Use the fetch snippet on this page, or hit "Run live" to try it now.
Is ISO 3166 Updates API up right now?
ISO 3166 Updates API is catalogued but not yet on our probe schedule, so we don't publish a live status for it. Check the provider's own status page or docs for its current state.