{"uid":"cap_K-RL5ObqDZaF9wOv6NFNe","slug":"international-address-formats-country-subdivisions-lookup-3a5763ad","name":"International Address Formats – Country Subdivisions Lookup","description":"Administrative divisions (states, provinces) of a country with codes, names and postal prefix patterns, from the dataset.","url":"https://address-formats.x402tookit.com/subdivisions?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"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["country"],"properties":{"q":{"type":"string","description":"Optional filter on code or name"},"limit":{"type":"integer","description":"Maximum rows (1-300, default 100)"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 code, e.g. CA"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"total":{"type":["null","number"]},"source":{"type":["null","string"]},"country":{"type":["null","string"]},"reasons":{"type":["array","null"]},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"returned":{"type":["null","number"]},"dataSource":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"attribution":{"type":["null","string"]},"snapshotDate":{"type":["null","string"]},"subdivisions":{"type":["array","null"],"items":{"type":"object","properties":{"code":{"type":["null","string"]},"name":{"type":["null","string"]},"latinName":{},"postalPrefixPattern":{"type":["null","string"]}}}},"subdivisionLabel":{"type":["null","string"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HO8v92ZgO66SmsG3cSsGC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns administrative divisions (states, provinces, regions) for a given country, including ISO codes, names, and postal prefix patterns.","exampleAgentPrompt":"Can you list all the provinces and territories of Canada with their ISO codes and postal prefix patterns?","exampleUseCases":[{"title":"Address form state dropdown population","prompt":"I need to build an address form for Australia — can you get me all the states and territories with their codes and names so I can populate the dropdown?"},{"title":"Postal prefix validation reference","prompt":"What are all the subdivisions of Germany with their postal prefix patterns? I want to cross-check which Bundesland a postal code belongs to."},{"title":"Localized region label lookup","prompt":"Can you fetch the administrative divisions for Brazil, including their local names and codes? I only need the first 50 results."}],"resultDescription":"A structured list of administrative subdivisions for the requested country, each containing a subdivision code, name, optional Latin name, and postal prefix pattern (where available). The response also includes the subdivision label used by that country (e.g. 'State', 'Province', 'Prefecture'), total count, data source attribution, and snapshot date.","failureModes":["Missing or invalid country code returns an error or empty result","Country code not in dataset returns no subdivisions","Filter query 'q' with no matching code or name returns empty subdivisions array","Limit out of range (below 1 or above 300) may cause validation error","Some countries may have null postal prefix patterns where data is unavailable"],"whenToPreferThis":"Use this endpoint when you need a structured, machine-readable list of a country's administrative divisions with ISO codes and postal prefix patterns — especially useful for populating address form dropdowns, validating state/province inputs, or building postal code routing logic. Prefer this over general geocoding APIs when you specifically need subdivision codes and postal metadata rather than geographic coordinates.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T12:30:27.147Z","isFirstParty":false,"canonicalSlug":"international-address-formats-country-subdivisions-lookup-3a5763ad"}