{"uid":"cap_jtTFCpuVVevt4dirhfMHM","slug":"2s-iso-3166-2-subdivision-lookup-20cb956a","name":"2s ISO 3166-2 Subdivision Lookup","description":"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.","url":"https://2s.io/api/iso/subdivision?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"required":[],"properties":{"code":{"type":"string","description":"ISO 3166-2 subdivision code, e.g. US-CA."},"country":{"type":"string","description":"2-letter ISO 3166-1 country code to list its subdivisions, e.g. US."}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"country":"US"}}},"response":{"data":{"found":true,"query":{"code":null,"country":"US"},"source":{"url":"https://www.iso.org/iso-3166-country-codes.html","license":"Public domain (ISO 3166-2 code list)","provider":"ISO 3166-2 subdivision codes (bundled; olahol/iso-3166-2.json)"},"country":"United States","subdivision":null,"subdivisions":[{"code":"US-AK","name":"Alaska","country":"US"},{"code":"US-AL","name":"Alabama","country":"US"},{"code":"US-AR","name":"Arkansas","country":"US"},{"code":"US-AS","name":"American Samoa","country":"US"},{"code":"US-AZ","name":"Arizona","country":"US"},{"code":"US-CA","name":"California","country":"US"},{"code":"US-CO","name":"Colorado","country":"US"},{"code":"US-CT","name":"Connecticut","country":"US"},{"code":"US-DC","name":"District of Columbia","country":"US"},{"code":"US-DE","name":"Delaware","country":"US"},{"code":"US-FL","name":"Florida","country":"US"},{"code":"US-GA","name":"Georgia","country":"US"},{"code":"US-GU","name":"Guam","country":"US"},{"code":"US-HI","name":"Hawaii","country":"US"},{"code":"US-IA","name":"Iowa","country":"US"},{"code":"US-ID","name":"Idaho","country":"US"},{"code":"US-IL","name":"Illinois","country":"US"},{"code":"US-IN","name":"Indiana","country":"US"},{"code":"US-KS","name":"Kansas","country":"US"},{"code":"US-KY","name":"Kentucky","country":"US"},{"code":"US-LA","name":"Louisiana","country":"US"},{"code":"US-MA","name":"Massachusetts","country":"US"},{"code":"US-MD","name":"Maryland","country":"US"},{"code":"US-ME","name":"Maine","country":"US"},{"code":"US-MI","name":"Michigan","country":"US"},{"code":"US-MN","name":"Minnesota","country":"US"},{"code":"US-MO","name":"Missouri","country":"US"},{"code":"US-MP","name":"Northern Mariana Islands","country":"US"},{"code":"US-MS","name":"Mississippi","country":"US"},{"code":"US-MT","name":"Montana","country":"US"},{"code":"US-NC","name":"North Carolina","country":"US"},{"code":"US-ND","name":"North Dakota","country":"US"},{"code":"US-NE","name":"Nebraska","country":"US"},{"code":"US-NH","name":"New Hampshire","country":"US"},{"code":"US-NJ","name":"New Jersey","country":"US"},{"code":"US-NM","name":"New Mexico","country":"US"},{"code":"US-NV","name":"Nevada","country":"US"},{"code":"US-NY","name":"New York","country":"US"},{"code":"US-OH","name":"Ohio","country":"US"},{"code":"US-OK","name":"Oklahoma","country":"US"},{"code":"US-OR","name":"Oregon","country":"US"},{"code":"US-PA","name":"Pennsylvania","country":"US"},{"code":"US-PR","name":"Puerto Rico","country":"US"},{"code":"US-RI","name":"Rhode Island","country":"US"},{"code":"US-SC","name":"South Carolina","country":"US"},{"code":"US-SD","name":"South Dakota","country":"US"},{"code":"US-TN","name":"Tennessee","country":"US"},{"code":"US-TX","name":"Texas","country":"US"},{"code":"US-UM","name":"United States Minor Outlying Islands","country":"US"},{"code":"US-UT","name":"Utah","country":"US"},{"code":"US-VA","name":"Virginia","country":"US"},{"code":"US-VI","name":"Virgin Islands, U.S.","country":"US"},{"code":"US-VT","name":"Vermont","country":"US"},{"code":"US-WA","name":"Washington","country":"US"},{"code":"US-WI","name":"Wisconsin","country":"US"},{"code":"US-WV","name":"West Virginia","country":"US"},{"code":"US-WY","name":"Wyoming","country":"US"}]},"meta":{"cost":{"usd":0.0012,"tier":0},"caller":"x402","version":null,"endpoint":"iso.subdivision","settlement":{"txHash":"0xbce0eafc54dca8b1e664f24e861f28ef74aae77c02501a0611f3768d2e2cf666","network":"eip155:8453","success":true}}}},"exampleRequest":{"country":"US"},"tags":["x402"],"displayCostAmount":"0.0012","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.0012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-ekxlXH_z_CR0bkNPYKnt","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up ISO 3166-2 subdivision codes (states, provinces, regions) by code or lists all subdivisions for a given country.","exampleAgentPrompt":"What is the full name and country for the ISO 3166-2 subdivision code US-CA?","exampleUseCases":null,"resultDescription":"Returns a JSON object indicating whether the subdivision was found, the queried code or country, the source provider, and either a single subdivision object (with code, name, and country) when looking up by code, or an array of subdivision objects when listing by country.","failureModes":["Invalid or unknown subdivision code returns found:false","Invalid country code returns found:false or empty subdivisions array","Missing both code and country parameters may return an error or empty result","Subdivision codes must follow ISO 3166-2 format (e.g. US-CA) or the lookup will fail"],"whenToPreferThis":"Use this endpoint when you need authoritative ISO 3166-2 subdivision data — either to decode a subdivision code to its human-readable name, or to enumerate all subdivisions for a given country. Prefer this over general geocoding APIs when you specifically need ISO-standard codes and names for states, provinces, or regions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T18:50:10.817Z","isFirstParty":false,"canonicalSlug":"2s-iso-3166-2-subdivision-lookup-20cb956a"}