ISO 3166 Updates API

ISO 3166 Updates API — Access all of the current and historical ISO 3166 chang

AUTH NONECORS ✓AGENT ✓HTTPS ✓COMMERCIAL ?

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.

78HOW IT'S SCORED ⓘ

▶ Run live Docs ↗

Status badge · for your README

Uptime history

100%90 days

100%30 days

1402P50 · ms

2526P95 · ms

operationalpartialdownno data

Response time · last 48 checks

Live response samplecaptured by our last successful check

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"
  }
}

Call itcurl · fetch · python

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())

Endpoints · 6HealthyFULL DOCS ↗

Monitored path responding — GET /api/all1402 mschecked 8h ago

GET/api/allPROBED

ISO 3166 Updates API — Access all of the current and historical ISO 3166 chang

GET/api

Api — documented GET route.

GET/api/1

Api details by ID (example: 1).

GET/api?limit=10

Api — documented GET route.

GET/api/search?q=test

Search by query parameters.

GET/api/alpha/%7Binput_alpha%7D

%7Binput Alpha%7D — documented GET route.

Machine-readable spec

We probe a documented GET and expect 2xx JSON — full uptime and health score. Export includes every documented route below.

Response-shape history

Stable. No schema drift observed since monitoring began — the response shape has not changed under our checks.

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 (500 req/window).

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?

As of our last scheduled check, ISO 3166 Updates API is healthy with 100% uptime over 90 days and a 1402 ms median response. We re-probe it every sweep — the status badge and uptime chart above always show the latest.

Metadatasome fields awaiting probe

Authfrom docsnone

CORSlive probeyes

Commercial usependingunclear

HTTPSlive probeyes

Free tierfrom docsFree — limits not published

Rate limitlive probe500 req/window

Card requiredfrom docsno

Data licensefrom docsUnverified

Base URL

In directory since2026-07-05

Agent contextpaste into chat

// iso-3166-updates-api · HEALTHY · health 78 · auth none · cors yes
{
  "base_url": "https://iso3166-updates.vercel.app",
  "sample": "https://iso3166-updates.vercel.app/api/all",
  "auth": "none",
  "status": "healthy",
  "commercial_use": "unclear",
  "docs": "https://iso3166-updates.vercel.app/api",
  "record": "https://shipapis.dev/api/v1/apis/iso-3166-updates-api"
}

Everything an agent needs to call ISO 3166 Updates API — from our last verified record.

Similar · health-ranked

Administrative Divisions DB100 VS

GeoJS100 VS

Postcodes.io100 VS

IPWhois100 VS

This page, as JSON

$ curl 'https://shipapis.dev/api/v1/apis/iso-3166-updates-api'

Health, uptime & verified metadata — free, no auth. Meta-API docs