{"uid":"cap_tMg5qvS-IbAwApbYHrpBu","slug":"international-address-formats-country-address-fields-lookup-70e0fb39","name":"International Address Formats – Country Address Fields Lookup","description":"Which address fields a country uses and their local labels: state/province/county, city, district, postal code.","url":"https://address-formats.x402tookit.com/country-address-fields?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":{"country":{"type":"string","description":"ISO 3166-1 alpha-2 code, e.g. IE"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"fields":{"type":["array","null"],"items":{"type":"object","properties":{"field":{"type":["null","string"]},"label":{"type":["null","string"]},"token":{"type":["null","string"]},"required":{"type":["boolean","null"]},"uppercase":{"type":["boolean","null"]}}}},"source":{"type":["null","string"]},"country":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"dataSource":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"attribution":{"type":["null","string"]},"countryName":{"type":["null","string"]},"hasCityField":{"type":["boolean","null"]},"snapshotDate":{"type":["null","string"]},"hasStateField":{"type":["boolean","null"]},"cityFieldLabel":{"type":["null","string"]},"hasSortingCode":{"type":["boolean","null"]},"stateFieldLabel":{"type":["null","string"]},"hasDistrictField":{"type":["boolean","null"]},"districtFieldLabel":{"type":["null","string"]},"hasPostalCodeField":{"type":["boolean","null"]},"subdivisionsListed":{"type":["null","number"]},"postalCodeFieldLabel":{"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_LYtPGy8AYcy8rlcUx1kaH","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 which address fields (state, city, district, postal code) a given country uses, along with their local labels and whether each field is required.","exampleAgentPrompt":"What address fields does Ireland (IE) use in its standard postal address, and what are their local labels?","exampleUseCases":[{"title":"Building a localized checkout form","prompt":"I'm building a checkout form and need to know which address fields Canada uses — things like whether there's a state/province field, a postal code, and what the local labels are for each field."},{"title":"Validating address data for a CRM import","prompt":"We're importing customer records from Japan into our CRM. Can you tell me which address fields Japan actually uses so I know what fields to expect and which ones are required?"},{"title":"Localizing address UI for a shipping app","prompt":"For our shipping app, I need to show the right address input fields depending on the user's country. Can you look up the address fields for Brazil, including their local labels and whether each one is required?"}],"resultDescription":"Returns a structured object containing: a list of address fields for the specified country (each with field name, local label, token, required flag, and uppercase flag), boolean flags indicating presence of city/state/district/postal code fields, local labels for those fields, country name, data source, snapshot date, and a summary. May also include degraded-mode indicators and attribution.","failureModes":["Missing or invalid country query parameter returns an error","Unsupported or unrecognized ISO country code may return null fields or empty field list","Degraded mode flag may be set if data source is incomplete for a given country","Network or payment (x402) failure prevents response"],"whenToPreferThis":"Use this endpoint when you need to know the structural composition of a country's postal address — which fields exist and their local labels — rather than how to format or validate a specific address. It is the right choice for building dynamic address forms, normalizing address data imports, or localizing UI labels per country. Prefer it over the layout/template endpoint when you need field-level metadata (required, uppercase, local label) rather than a line-order template.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T12:31:13.555Z","isFirstParty":false,"canonicalSlug":"international-address-formats-country-address-fields-lookup-70e0fb39"}