{"openapi":"3.1.0","info":{"title":"Country Subdivisions API","version":"1.0.0","description":"Look up the administrative subdivisions of any country — 5,300+ states, provinces, regions and districts across 229 countries, with ISO 3166-2 codes. Search by name, country or type, fetch all subdivisions of a country (perfect for address-form dropdowns), or resolve an ISO 3166-2 code like US-CA to its name, type and coordinates. Bundled, fast and always available.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/regions-api","description":"oanor gateway"}],"tags":[{"name":"Subdivisions"},{"name":"Countries"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/by-country":{"get":{"operationId":"get_v1_by_country","tags":["Subdivisions"],"summary":"All subdivisions of one country","description":"","parameters":[{"name":"country","in":"query","required":true,"description":"ISO-2 country code","schema":{"type":"string"},"example":"US"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":60,"country":"US","country_name":"United States","subdivisions":[{"id":1456,"code":"AL","name":"Alabama","type":"state","latitude":33.25888,"iso3166_2":"US-AL","longitude":-86.82953,"country_code":"US","country_name":"United States"},{"id":1400,"code":"AK","name":"Alaska","type":"state","latitude":64.44596,"iso3166_2":"US-AK","longitude":-149.68091,"country_code":"US","country_name":"United States"},{"id":1424,"code":"AS","name":"American Samoa","type":"outlying area","latitude":-14.29712,"iso3166_2":"US-AS","longitude":-170.71315,"country_code":"US","country_name":"United States"},{"id":1434,"code":"AZ","name":"Arizona","type":"state","latitude":34.39534,"iso3166_2":"US-AZ","longitude":-111.76327,"country_code":"US","country_name":"United States"},{"id":1444,"code":"AR","name":"Arkansas","type":"state","latitude":35.20489,"iso3166_2":"US-AR","longitude":-92.44791,"country_code":"US","country_name":"United States"},{"id":5815,"code":"AE","name":"Armed Forces Europe","type":"military postal region","country_code":"US","country_name":"United States"},{"id":5816,"code":"AA","name":"Armed Forces of the Americas","type":"military postal region","country_code":"US","country_name":"United States"},{"id":5817,"code":"AP","name":"Armed Forces Pacific","type":"military postal region","country_code":"US","country_name":"United States"},{"id":1416,"code":"CA","name":"California","type":"state","latitude":36.70146,"iso3166_2":"US-CA","longitude":-118.756,"country_code":"US","country_name":"United States"},{"id":1450,"code":"CO","name":"Colorado","type":"state","latitude":38.72518,"iso3166_2":"US-CO","longitude":-105.60772,"country_code":"US","country_name":"United States"},{"id":1435,"code":"CT","name":"Connecticut","type":"state","latitude":41.65002,"iso3166_2":"US-CT","longitude":-72.73422,"country_code":"US","country_name":"United States"},{"id":1399,"code":"DE","name":"Delaware","type":"state","latitude":38.69205,"iso3166_2":"US-DE","longitude":-75.40133,"country_code":"US","country_name":"United States"},{"id":1437,"code":"DC","name":"District of Columbia","type":"district","latitude":38.89504,"iso3166_2":"US-DC","longitude":-77.03654,"country_code":"US","country_name":"United States"},{"id":1436,"code":"FL","name":"Florida","type":"state","latitude":27.75677,"iso3166_2":"US-FL","longitude":-81.46398,"country_code":"US","country_name":"United States"},{"id":1455,"code":"GA","name":"Georgia","type":"state","latitude":32.32938,"iso3166_2":"US-GA","longitude":-83.11374,"country_code":"US","country_name":"United States"},{"id":1412,"code":"GU","name":"Guam","type":"outlying area","latitude":13.44999,"iso3166_2":"US-GU","longitude":144.76517,"country_code":"US","country_name":"United States"},{"id":1411,"code":"HI","name":"Hawaii","type":"state","latitude":19.62733,"iso3166_2":"US-HI","longitude":-155.56456,"country_code":"US","country_name":"United States"},{"id":1460,"code":"ID","name":"Idaho","type":"state","latitude":43.64476,"iso3166_2":"US-ID","longitude":-114.01541,"country_code":"US","country_name":"United States"},{"id":1425,"code":"IL","name":"Illinois","type":"state","latitude":40.07966,"iso3166_2":"US-IL","longitude":-89.43373,"country_code":"US","country_name":"United States"},{"id":1440,"code":"IN","name":"Indiana","type":"state","latitude":40.32701,"iso3166_2":"US-IN","longitude":-86.17469,"country_code":"US","country_name":"United States"},{"id":1459,"code":"IA","name":"Iowa","type":"state","latitude":41.92167,"iso3166_2":"US-IA","longitude":-93.31227,"country_code":"US","country_name":"United States"},{"id":1406,"code":"KS","name":"Kansas","type":"state","latitude":38.27312,"iso3166_2":"US-KS","longitude":-98.58219,"country_code":"US","country_name":"United States"},{"id":1419,"code":"KY","name":"Kentucky","type":"state","latitude":37.5726,"iso3166_2":"US-KY","longitude":-85.15514,"country_code":"US","country_name":"United States"},{"id":1457,"code":"LA","name":"Louisiana","type":"state","latitude":30.87039,"iso3166_2":"US-LA","longitude":-92.00713,"country_code":"US","country_name":"United States"},{"id":1453,"code":"ME","name":"Maine","type":"state","latitude":45.7091,"iso3166_2":"US-ME","longitude":-68.85902,"country_code":"US","country_name":"United States"},{"id":1401,"code":"MD","name":"Maryland","type":"state","latitude":39.51624,"iso3166_2":"US-MD","longitude":-76.93821,"country_code":"US","country_name":"United States"},{"id":1433,"code":"MA","name":"Massachusetts","type":"state","latitude":42.37888,"iso3166_2":"US-MA","longitude":-72.03237,"country_code":"US","country_name":"United States"},{"id":1426,"code":"MI","name":"Michigan","type":"state","latitude":43.6212,"iso3166_2":"US-MI","longitude":-84.68243,"country_code":"US","country_name":"United States"},{"id":1420,"code":"MN","name":"Minnesota","type":"state","latitude":45.98966,"iso3166_2":"US-MN","longitude":-94.61133,"country_code":"US","country_name":"United States"},{"id":1430,"code":"MS","name":"Mississippi","type":"state","latitude":32.97153,"iso3166_2":"US-MS","longitude":-89.73485,"country_code":"US","country_name":"United States"},{"id":1451,"code":"MO","name":"Missouri","type":"state","latitude":38.76048,"iso3166_2":"US-MO","longitude":-92.56179,"country_code":"US","country_name":"United States"},{"id":1446,"code":"MT","name":"Montana","type":"state","latitude":47.37527,"iso3166_2":"US-MT","longitude":-109.63876,"country_code":"US","country_name":"United States"},{"id":1408,"code":"NE","name":"Nebraska","type":"state","latitude":41.73702,"iso3166_2":"US-NE","longitude":-99.58738,"country_code":"US","country_name":"United States"},{"id":1458,"code":"NV","name":"Nevada","type":"state","latitude":39.51588,"iso3166_2":"US-NV","longitude":-116.85372,"country_code":"US","country_name":"United States"},{"id":1404,"code":"NH","name":"New Hampshire","type":"state","latitude":43.48491,"iso3166_2":"US-NH","longitude":-71.6554,"country_code":"US","country_name":"United States"},{"id":1417,"code":"NJ","name":"New Jersey","type":"state","latitude":40.07574,"iso3166_2":"US-NJ","longitude":-74.40416,"country_code":"US","country_name":"United States"},{"id":1423,"code":"NM","name":"New Mexico","type":"state","latitude":34.58021,"iso3166_2":"US-NM","longitude":-105.99605,"country_code":"US","country_name":"United States"},{"id":1452,"code":"NY","name":"New York","type":"state","latitude":40.71278,"iso3166_2":"US-NY","longitude":-74.00597,"country_code":"US","country_name":"United States"},{"id":1447,"code":"NC","name":"North Carolina","type":"state","latitude":35.67296,"iso3166_2":"US-NC","longitude":-79.03929,"country_code":"US","country_name":"United States"},{"id":1418,"code":"ND","name":"North Dakota","type":"state","latitude":47.62015,"iso3166_2":"US-ND","longitude":-100.54074,"country_code":"US","country_name":"United States"},{"id":1431,"code":"MP","name":"Northern Mariana Islands","type":"outlying area","latitude":15.17536,"iso3166_2":"US-MP","longitude":145.73793,"country_code":"US","country_name":"United States"},{"id":4851,"code":"OH","name":"Ohio","type":"state","latitude":40.22536,"iso3166_2":"US-OH","longitude":-82.68814,"country_code":"US","country_name":"United States"},{"id":1421,"code":"OK","name":"Oklahoma","type":"state","latitude":35.5545,"iso3166_2":"US-OK","longitude":-97.43662,"country_code":"US","country_name":"United States"},{"id":1415,"code":"OR","name":"Oregon","type":"state","latitude":43.97928,"iso3166_2":"US-OR","longitude":-120.73726,"country_code":"US","country_name":"United States"},{"id":1422,"code":"PA","name":"Pennsylvania","type":"state","latitude":40.96999,"iso3166_2":"US-PA","longitude":-77.72788,"country_code":"US","country_name":"United States"},{"id":1449,"code":"PR","name":"Puerto Rico","type":"outlying area","latitude":18.22477,"iso3166_2":"US-PR","longitude":-66.48583,"country_code":"US","country_name":"United States"},{"id":1461,"code":"RI","name":"Rhode Island","type":"state","latitude":41.79624,"iso3166_2":"US-RI","longitude":-71.59924,"country_code":"US","country_name":"United States"},{"id":1443,"code":"SC","name":"South Carolina","type":"state","latitude":33.68744,"iso3166_2":"US-SC","longitude":-80.43637,"country_code":"US","country_name":"United States"},{"id":1445,"code":"SD","name":"South Dakota","type":"state","latitude":44.64718,"iso3166_2":"US-SD","longitude":-100.34876,"country_code":"US","country_name":"United States"},{"id":1454,"code":"TN","name":"Tennessee","type":"state","latitude":35.77301,"iso3166_2":"US-TN","longitude":-86.28201,"country_code":"US","country_name":"United States"},{"id":1407,"code":"TX","name":"Texas","type":"state","latitude":31.26389,"iso3166_2":"US-TX","longitude":-98.54561,"country_code":"US","country_name":"United States"},{"id":1432,"code":"UM","name":"United States Minor Outlying Islands","type":"outlying area","latitude":28.23605,"iso3166_2":"US-UM","longitude":-177.36856,"country_code":"US","country_name":"United States"},{"id":1413,"code":"VI","name":"United States Virgin Islands","type":"outlying area","latitude":17.78919,"iso3166_2":"US-VI","longitude":-64.70806,"country_code":"US","country_name":"United States"},{"id":1414,"code":"UT","name":"Utah","type":"state","latitude":39.42252,"iso3166_2":"US-UT","longitude":-111.71436,"country_code":"US","country_name":"United States"},{"id":1409,"code":"VT","name":"Vermont","type":"state","latitude":44.59907,"iso3166_2":"US-VT","longitude":-72.50026,"country_code":"US","country_name":"United States"},{"id":1427,"code":"VA","name":"Virginia","type":"state","latitude":37.12322,"iso3166_2":"US-VA","longitude":-78.49277,"country_code":"US","country_name":"United States"},{"id":1462,"code":"WA","name":"Washington","type":"state","latitude":47.28684,"iso3166_2":"US-WA","longitude":-120.21261,"country_code":"US","country_name":"United States"},{"id":1429,"code":"WV","name":"West Virginia","type":"state","latitude":38.47584,"iso3166_2":"US-WV","longitude":-80.84084,"country_code":"US","country_name":"United States"},{"id":1441,"code":"WI","name":"Wisconsin","type":"state","latitude":44.4309,"iso3166_2":"US-WI","longitude":-89.68846,"country_code":"US","country_name":"United States"},{"id":1442,"code":"WY","name":"Wyoming","type":"state","latitude":43.17003,"iso3166_2":"US-WY","longitude":-107.56853,"country_code":"US","country_name":"United States"}]},"meta":{"timestamp":"2026-05-31T01:20:52.329Z","request_id":"4f5d5029-5a90-49f7-a1f9-35698361c8c8"},"status":"ok","message":"Subdivisions retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Subdivisions"],"summary":"Search subdivisions by name, country and type","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Subdivision name (substring)","schema":{"type":"string"},"example":"bavaria"},{"name":"country","in":"query","required":false,"description":"Filter by ISO-2 country code","schema":{"type":"string"},"example":"DE"},{"name":"type","in":"query","required":false,"description":"Type, e.g. state, province, region, district","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results per page (1-100, default 20)","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":1,"limit":20,"total":1,"offset":0,"filters":{"q":"bavaria","country":"DE"},"results":[{"id":3009,"code":"BY","name":"Bavaria","type":"land","latitude":48.94676,"iso3166_2":"DE-BY","longitude":11.40387,"country_code":"DE","country_name":"Germany"}]},"meta":{"timestamp":"2026-05-31T01:20:52.377Z","request_id":"565276fc-c96c-4ea7-9084-21b0d4a90c0a"},"status":"ok","message":"Search completed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/subdivision":{"get":{"operationId":"get_v1_subdivision","tags":["Subdivisions"],"summary":"A single subdivision by ISO 3166-2 code or id","description":"","parameters":[{"name":"code","in":"query","required":false,"description":"ISO 3166-2 code, e.g. US-CA","schema":{"type":"string"},"example":"US-CA"},{"name":"id","in":"query","required":false,"description":"Dataset id (alternative to code)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"id":1416,"code":"CA","name":"California","type":"state","latitude":36.70146,"iso3166_2":"US-CA","longitude":-118.756,"country_code":"US","country_name":"United States"},"meta":{"timestamp":"2026-05-31T01:20:52.450Z","request_id":"18ce2759-2fdf-4e32-a013-c64c9cf1d29c"},"status":"ok","message":"Subdivision retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/countries":{"get":{"operationId":"get_v1_countries","tags":["Countries"],"summary":"Countries with subdivision counts","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":229,"countries":[{"country_code":"GB","country_name":"United Kingdom","subdivisions":221},{"country_code":"SI","country_name":"Slovenia","subdivisions":212},{"country_code":"UG","country_name":"Uganda","subdivisions":139},{"country_code":"IT","country_name":"Italy","subdivisions":126},{"country_code":"FR","country_name":"France","subdivisions":124},{"country_code":"PH","country_name":"Philippines","subdivisions":99},{"country_code":"EE","country_name":"Estonia","subdivisions":94},{"country_code":"CZ","country_name":"Czech Republic","subdivisions":90},{"country_code":"MA","country_name":"Morocco","subdivisions":87},{"country_code":"RU","country_name":"Russia","subdivisions":83},{"country_code":"TR","country_name":"Turkey","subdivisions":81},{"country_code":"MK","country_name":"North Macedonia","subdivisions":80},{"country_code":"AZ","country_name":"Azerbaijan","subdivisions":78},{"country_code":"PR","country_name":"Puerto Rico","subdivisions":78},{"country_code":"TH","country_name":"Thailand","subdivisions":78},{"country_code":"BD","country_name":"Bangladesh","subdivisions":72},{"country_code":"IS","country_name":"Iceland","subdivisions":72},{"country_code":"LT","country_name":"Lithuania","subdivisions":70},{"country_code":"ES","country_name":"Spain","subdivisions":69},{"country_code":"MT","country_name":"Malta","subdivisions":68},{"country_code":"US","country_name":"United States","subdivisions":60},{"country_code":"DZ","country_name":"Algeria","subdivisions":58},{"country_code":"BF","country_name":"Burkina Faso","subdivisions":58},{"country_code":"JP","country_name":"Japan","subdivisions":47},{"country_code":"KE","country_name":"Kenya","subdivisions":47},{"country_code":"ID","country_name":"Indonesia","subdivisions":45},{"country_code":"HU","country_name":"Hungary","subdivisions":43},{"country_code":"LV","country_name":"Latvia","subdivisions":43},{"country_code":"DO","country_name":"Dominican Republic","subdivisions":42},{"country_code":"RO","country_name":"Romania","subdivisions":42},{"country_code":"GN","country_name":"Guinea","subdivisions":41},{"country_code":"MD","country_name":"Moldova","subdivisions":37},{"country_code":"NG","country_name":"Nigeria","subdivisions":37},{"country_code":"IN","country_name":"India","subdivisions":36},{"country_code":"AF","country_name":"Afghanistan","subdivisions":34},{"country_code":"CN","country_name":"China","subdivisions":34},{"country_code":"LK","country_name":"Sri Lanka","subdivisions":34},{"country_code":"VN","country_name":"Vietnam","subdivisions":34},{"country_code":"CO","country_name":"Colombia","subdivisions":33},{"country_code":"MX","country_name":"Mexico","subdivisions":32},{"country_code":"RS","country_name":"Serbia","subdivisions":32},{"country_code":"BS","country_name":"The Bahamas","subdivisions":32},{"country_code":"IR","country_name":"Iran","subdivisions":31},{"country_code":"MW","country_name":"Malawi","subdivisions":31},{"country_code":"TZ","country_name":"Tanzania","subdivisions":31},{"country_code":"IE","country_name":"Ireland","subdivisions":30},{"country_code":"BG","country_name":"Bulgaria","subdivisions":28},{"country_code":"BR","country_name":"Brazil","subdivisions":27},{"country_code":"EG","country_name":"Egypt","subdivisions":27},{"country_code":"SC","country_name":"Seychelles","subdivisions":27},{"country_code":"UA","country_name":"Ukraine","subdivisions":27},{"country_code":"CD","country_name":"Democratic Republic of the Congo","subdivisions":26},{"country_code":"MH","country_name":"Marshall Islands","subdivisions":26},{"country_code":"PE","country_name":"Peru","subdivisions":26},{"country_code":"CH","country_name":"Switzerland","subdivisions":26},{"country_code":"KH","country_name":"Cambodia","subdivisions":25},{"country_code":"ME","country_name":"Montenegro","subdivisions":25},{"country_code":"VE","country_name":"Venezuela","subdivisions":25},{"country_code":"AR","country_name":"Argentina","subdivisions":24},{"country_code":"CV","country_name":"Cape Verde","subdivisions":24},{"country_code":"EC","country_name":"Ecuador","subdivisions":24},{"country_code":"TN","country_name":"Tunisia","subdivisions":24},{"country_code":"TD","country_name":"Chad","subdivisions":23},{"country_code":"GT","country_name":"Guatemala","subdivisions":22},{"country_code":"LY","country_name":"Libya","subdivisions":22},{"country_code":"MN","country_name":"Mongolia","subdivisions":22},{"country_code":"PG","country_name":"Papua New Guinea","subdivisions":22},{"country_code":"TW","country_name":"Taiwan","subdivisions":22},{"country_code":"YE","country_name":"Yemen","subdivisions":22},{"country_code":"MV","country_name":"Maldives","subdivisions":21},{"country_code":"SE","country_name":"Sweden","subdivisions":21},{"country_code":"BT","country_name":"Bhutan","subdivisions":20},{"country_code":"HR","country_name":"Croatia","subdivisions":20},{"country_code":"KZ","country_name":"Kazakhstan","subdivisions":20},{"country_code":"PT","country_name":"Portugal","subdivisions":20},{"country_code":"FJ","country_name":"Fiji Islands","subdivisions":19},{"country_code":"GU","country_name":"Guam","subdivisions":19},{"country_code":"IQ","country_name":"Iraq","subdivisions":19},{"country_code":"UY","country_name":"Uruguay","subdivisions":19},{"country_code":"AO","country_name":"Angola","subdivisions":18},{"country_code":"BI","country_name":"Burundi","subdivisions":18},{"country_code":"FI","country_name":"Finland","subdivisions":18},{"country_code":"HN","country_name":"Honduras","subdivisions":18},{"country_code":"HK","country_name":"Hong Kong S.A.R.","subdivisions":18},{"country_code":"LA","country_name":"Laos","subdivisions":18},{"country_code":"PY","country_name":"Paraguay","subdivisions":18},{"country_code":"SO","country_name":"Somalia","subdivisions":18},{"country_code":"SD","country_name":"Sudan","subdivisions":18},{"country_code":"CF","country_name":"Central African Republic","subdivisions":17},{"country_code":"YT","country_name":"Mayotte","subdivisions":17},{"country_code":"MC","country_name":"Monaco","subdivisions":17},{"country_code":"NZ","country_name":"New Zealand","subdivisions":17},{"country_code":"NI","country_name":"Nicaragua","subdivisions":17},{"country_code":"NO","country_name":"Norway","subdivisions":17},{"country_code":"KR","country_name":"South Korea","subdivisions":17},{"country_code":"TT","country_name":"Trinidad and Tobago","subdivisions":17},{"country_code":"AX","country_name":"Aland Islands","subdivisions":16},{"country_code":"BW","country_name":"Botswana","subdivisions":16},{"country_code":"CL","country_name":"Chile","subdivisions":16},{"country_code":"CU","country_name":"Cuba","subdivisions":16},{"country_code":"DE","country_name":"Germany","subdivisions":16},{"country_code":"GH","country_name":"Ghana","subdivisions":16},{"country_code":"MY","country_name":"Malaysia","subdivisions":16},{"country_code":"PW","country_name":"Palau","subdivisions":16},{"country_code":"PS","country_name":"Palestinian Territory Occupied","subdivisions":16},{"country_code":"PL","country_name":"Poland","subdivisions":16},{"country_code":"KN","country_name":"Saint Kitts and Nevis","subdivisions":16},{"country_code":"GR","country_name":"Greece","subdivisions":15},{"country_code":"LR","country_name":"Liberia","subdivisions":15},{"country_code":"MR","country_name":"Mauritania","subdivisions":15},{"country_code":"MM","country_name":"Myanmar","subdivisions":15},{"country_code":"AI","country_name":"Anguilla","subdivisions":14},{"country_code":"SV","country_name":"El Salvador","subdivisions":14},{"country_code":"CI","country_name":"Ivory Coast","subdivisions":14},{"country_code":"JM","country_name":"Jamaica","subdivisions":14},{"country_code":"NA","country_name":"Namibia","subdivisions":14},{"country_code":"NR","country_name":"Nauru","subdivisions":14},{"country_code":"NU","country_name":"Niue","subdivisions":14},{"country_code":"PA","country_name":"Panama","subdivisions":14},{"country_code":"SN","country_name":"Senegal","subdivisions":14},{"country_code":"SY","country_name":"Syria","subdivisions":14},{"country_code":"UZ","country_name":"Uzbekistan","subdivisions":14},{"country_code":"BE","country_name":"Belgium","subdivisions":13},{"country_code":"CA","country_name":"Canada","subdivisions":13},{"country_code":"ET","country_name":"Ethiopia","subdivisions":13},{"country_code":"KP","country_name":"North Korea","subdivisions":13},{"country_code":"SA","country_name":"Saudi Arabia","subdivisions":13},{"country_code":"TL","country_name":"Timor-Leste","subdivisions":13},{"country_code":"AL","country_name":"Albania","subdivisions":12},{"country_code":"BJ","country_name":"Benin","subdivisions":12},{"country_code":"CG","country_name":"Congo","subdivisions":12},{"country_code":"GE","country_name":"Georgia","subdivisions":12},{"country_code":"GG","country_name":"Guernsey","subdivisions":12},{"country_code":"GW","country_name":"Guinea-Bissau","subdivisions":12},{"country_code":"JE","country_name":"Jersey","subdivisions":12},{"country_code":"JO","country_name":"Jordan","subdivisions":12},{"country_code":"LU","country_name":"Luxembourg","subdivisions":12},{"country_code":"MU","country_name":"Mauritius","subdivisions":12},{"country_code":"NL","country_name":"Netherlands","subdivisions":12},{"country_code":"AM","country_name":"Armenia","subdivisions":11},{"country_code":"BB","country_name":"Barbados","subdivisions":11},{"country_code":"LI","country_name":"Liechtenstein","subdivisions":11},{"country_code":"ML","country_name":"Mali","subdivisions":11},{"country_code":"MZ","country_name":"Mozambique","subdivisions":11},{"country_code":"OM","country_name":"Oman","subdivisions":11},{"country_code":"WS","country_name":"Samoa","subdivisions":11},{"country_code":"CM","country_name":"Cameroon","subdivisions":10},{"country_code":"DM","country_name":"Dominica","subdivisions":10},{"country_code":"GQ","country_name":"Equatorial Guinea","subdivisions":10},{"country_code":"GY","country_name":"Guyana","subdivisions":10},{"country_code":"HT","country_name":"Haiti","subdivisions":10},{"country_code":"LS","country_name":"Lesotho","subdivisions":10},{"country_code":"LC","country_name":"Saint Lucia","subdivisions":10},{"country_code":"SB","country_name":"Solomon Islands","subdivisions":10},{"country_code":"SS","country_name":"South Sudan","subdivisions":10},{"country_code":"SR","country_name":"Suriname","subdivisions":10},{"country_code":"ZM","country_name":"Zambia","subdivisions":10},{"country_code":"ZW","country_name":"Zimbabwe","subdivisions":10},{"country_code":"AW","country_name":"Aruba","subdivisions":9},{"country_code":"AT","country_name":"Austria","subdivisions":9},{"country_code":"BM","country_name":"Bermuda","subdivisions":9},{"country_code":"BO","country_name":"Bolivia","subdivisions":9},{"country_code":"GA","country_name":"Gabon","subdivisions":9},{"country_code":"KG","country_name":"Kyrgyzstan","subdivisions":9},{"country_code":"SM","country_name":"San Marino","subdivisions":9},{"country_code":"ZA","country_name":"South Africa","subdivisions":9},{"country_code":"UM","country_name":"United States Minor Outlying Islands","subdivisions":9},{"country_code":"AG","country_name":"Antigua and Barbuda","subdivisions":8},{"country_code":"AU","country_name":"Australia","subdivisions":8},{"country_code":"LB","country_name":"Lebanon","subdivisions":8},{"country_code":"NE","country_name":"Niger","subdivisions":8},{"country_code":"QA","country_name":"Qatar","subdivisions":8},{"country_code":"SH","country_name":"Saint Helena","subdivisions":8},{"country_code":"SK","country_name":"Slovakia","subdivisions":8},{"country_code":"TV","country_name":"Tuvalu","subdivisions":8},{"country_code":"AD","country_name":"Andorra","subdivisions":7},{"country_code":"BY","country_name":"Belarus","subdivisions":7},{"country_code":"CR","country_name":"Costa Rica","subdivisions":7},{"country_code":"GD","country_name":"Grenada","subdivisions":7},{"country_code":"XK","country_name":"Kosovo","subdivisions":7},{"country_code":"NP","country_name":"Nepal","subdivisions":7},{"country_code":"PK","country_name":"Pakistan","subdivisions":7},{"country_code":"ST","country_name":"Sao Tome and Principe","subdivisions":7},{"country_code":"AE","country_name":"United Arab Emirates","subdivisions":7},{"country_code":"BZ","country_name":"Belize","subdivisions":6},{"country_code":"CY","country_name":"Cyprus","subdivisions":6},{"country_code":"DJ","country_name":"Djibouti","subdivisions":6},{"country_code":"ER","country_name":"Eritrea","subdivisions":6},{"country_code":"FO","country_name":"Faroe Islands","subdivisions":6},{"country_code":"IL","country_name":"Israel","subdivisions":6},{"country_code":"KW","country_name":"Kuwait","subdivisions":6},{"country_code":"MG","country_name":"Madagascar","subdivisions":6},{"country_code":"IM","country_name":"Man (Isle of)","subdivisions":6},{"country_code":"VC","country_name":"Saint Vincent and the Grenadines","subdivisions":6},{"country_code":"GM","country_name":"The Gambia","subdivisions":6},{"country_code":"TM","country_name":"Turkmenistan","subdivisions":6},{"country_code":"TC","country_name":"Turks and Caicos Islands","subdivisions":6},{"country_code":"VU","country_name":"Vanuatu","subdivisions":6},{"country_code":"AS","country_name":"American Samoa","subdivisions":5},{"country_code":"DK","country_name":"Denmark","subdivisions":5},{"country_code":"PF","country_name":"French Polynesia","subdivisions":5},{"country_code":"TF","country_name":"French Southern Territories","subdivisions":5},{"country_code":"GL","country_name":"Greenland","subdivisions":5},{"country_code":"RW","country_name":"Rwanda","subdivisions":5},{"country_code":"SL","country_name":"Sierra Leone","subdivisions":5},{"country_code":"SG","country_name":"Singapore","subdivisions":5},{"country_code":"TJ","country_name":"Tajikistan","subdivisions":5},{"country_code":"TG","country_name":"Togo","subdivisions":5},{"country_code":"TO","country_name":"Tonga","subdivisions":5},{"country_code":"BH","country_name":"Bahrain","subdivisions":4},{"country_code":"BN","country_name":"Brunei","subdivisions":4},{"country_code":"SZ","country_name":"Eswatini","subdivisions":4},{"country_code":"MQ","country_name":"Martinique","subdivisions":4},{"country_code":"FM","country_name":"Micronesia","subdivisions":4},{"country_code":"RE","country_name":"Reunion","subdivisions":4},{"country_code":"BQ","country_name":"Bonaire, Sint Eustatius and Saba","subdivisions":3},{"country_code":"BA","country_name":"Bosnia and Herzegovina","subdivisions":3},{"country_code":"KY","country_name":"Cayman Islands","subdivisions":3},{"country_code":"KM","country_name":"Comoros","subdivisions":3},{"country_code":"KI","country_name":"Kiribati","subdivisions":3},{"country_code":"MS","country_name":"Montserrat","subdivisions":3},{"country_code":"NC","country_name":"New Caledonia","subdivisions":3},{"country_code":"VI","country_name":"Virgin Islands (US)","subdivisions":3},{"country_code":"WF","country_name":"Wallis and Futuna Islands","subdivisions":3},{"country_code":"GP","country_name":"Guadeloupe","subdivisions":2},{"country_code":"GF","country_name":"French Guiana","subdivisions":1},{"country_code":"PM","country_name":"Saint Pierre and Miquelon","subdivisions":1},{"country_code":"BL","country_name":"Saint-Barthelemy","subdivisions":1},{"country_code":"MF","country_name":"Saint-Martin (French part)","subdivisions":1}],"total_subdivisions":5308},"meta":{"timestamp":"2026-05-31T01:20:52.520Z","request_id":"c37da041-6f25-4b89-8184-4a5b6c2e048e"},"status":"ok","message":"Countries retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Totals, types & source","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"total":5308,"types":["administered area","administration","administrative atoll","administrative precinct","administrative region","administrative territory","arctic region","area","atoll","autonomous city","autonomous community","autonomous district","autonomous municipality","autonomous province","autonomous region","autonomous republic","autonomous sector","autonomous territorial unit","borough","canton","capital city","capital district","capital territory","chain","city","city municipality","city with county rights","commune","council area","country","county","decentralized regional entity","department","dependency","district","district municipality","districts under republic administration","division","economic prefecture","emirate","entity","european collectivity","federal capital territory","federal dependency","federal district","federal territory","free municipal consortium","geographical region","geographical unit","governorate","indigenous region","island","island council","land","local council","london borough","metropolitan administration","metropolitan city","metropolitan collectivity with special status","metropolitan department","metropolitan district","metropolitan region","military postal region","municipality","oblast","outlying area","overseas collectivity","overseas collectivity with special status","overseas region","overseas territory","parish","popularate","prefecture","province","quarter","region","regional unit","republic","rural municipality","sheadings","special administrative region","special city","special island authority","special municipality","special region","special self-governing city","special self-governing province","state","state city","territorial unit","territory","town","town council","two-tier county","union territory","unitary authority","urban community","urban municipality","village","voivodship","ward"],"fields":["id","name","code","iso3166_2","type","country_code","country_name","latitude","longitude"],"source":"ISO 3166-2 (countries-states-cities database)","countries":229},"meta":{"timestamp":"2026-05-31T01:20:52.595Z","request_id":"baac755d-63a4-44d8-a947-54a86460014b"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":500,"monthly_call_quota":40000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1500,"monthly_call_quota":300000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":4200,"monthly_call_quota":2500000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/regions-api"}