iso

Look up ISO 3166-2 subdivisions (states, provinces, regions).

Look up ISO 3166-2 subdivisions (states, provinces, regions). Pass code (e.g. US-CA) to resolve a single subdivision → name + country, or country (2-letter ISO 3166-1, e.g. US) to list all of that country's subdivisions with their codes. Bundled authoritative ISO 3166-2 data (~3.8k subdivisions across 237 countries) — the address/jurisdiction ground truth an LLM hallucinates codes for.

get/api/iso/subdivision

Request

  • Base URL: https://2s.io
  • URL: https://2s.io/api/iso/subdivision
  • Auth: API key in header PAYMENT-SIGNATURE

Query parameters

codestring

Code to look up.

countrystring

Country name or ISO country code.

trial1

Try before you buy. Set to 1 for one free real call per endpoint per hour — no wallet or payment needed — to verify the endpoint before paying. Equivalent to sending the "X-2s-Trial: 1" request header. Listed only on operations that offer a trial; the others always answer 402.

Response

(unresolved $ref)

Changes

No recorded changes to this operation across all 1 revision of this API.