{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-developer-resources/ingrid-api/guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Country reference","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"country-reference","__idx":0},"children":["Country reference"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Address requirements vary by country. This reference documents the fields,"," ","formats, and rules that affect how addresses are collected and validated in each"," ","supported country."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For most integrations, you do not need to implement country-specific logic — the"," ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/developer-resources/ingrid-api/guides/address-form"},"children":["address form endpoint"]}," returns the correct fields and"," ","validation rules for each country automatically. This reference is useful when"," ","you need to understand the rules behind the form, debug validation issues, or"," ","build custom address handling."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"summary","__idx":1},"children":["Summary"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Country"},"children":["Country"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Postal code format"},"children":["Postal code format"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"administrativeArea required"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["administrativeArea"]}," required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Street/number order"},"children":["Street/number order"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Detail"},"children":["Detail"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sweden"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5 digits"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Street before number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/developer-resources/ingrid-api/guides/country-reference/sweden"},"children":["Details"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["United Kingdom"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GB"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Alphanumeric + space"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Number before street"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/developer-resources/ingrid-api/guides/country-reference/united-kingdom"},"children":["Details"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["United States"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["US"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5 digits (or 5+4)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes (state)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Number before street"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/developer-resources/ingrid-api/guides/country-reference/united-states"},"children":["Details"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Germany"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5 digits"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Street before number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/developer-resources/ingrid-api/guides/country-reference/germany"},"children":["Details"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Norway"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NO"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["4 digits"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Street before number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Denmark"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DK"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["4 digits"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Street before number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Finland"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FI"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5 digits"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Street before number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Netherlands"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["4 digits + 2 letters"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Street before number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["France"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5 digits"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Number before street"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Spain"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ES"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5 digits"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes (province)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Street before number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Italy"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5 digits"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes (province, 2-letter)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Street before number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Austria"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["4 digits"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Street before number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Poland"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2 digits + dash + 3 digits"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Street before number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Canada"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CA"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Letter-digit alternating"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes (province)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Number before street"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Australia"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AU"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["4 digits"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes (state/territory)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Number before street"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Japan"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["JP"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3 digits + dash + 4 digits"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes (prefecture)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Street before number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Brazil"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5 digits + dash + 3 digits"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes (state)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Street before number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ireland"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Eircode (7 chars)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes (county)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Number before street"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Countries without a detail page link follow the general patterns described in"," ","their row. Detail pages are added as integrations in those markets grow."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"common-patterns","__idx":2},"children":["Common patterns"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"postal-code-sanitization","__idx":3},"children":["Postal code sanitization"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API automatically sanitizes postal codes on input:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Digits only"]}," (SE, NO, DK, FI, DE, AT): all non-digit characters are stripped"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Digits and spaces"]}," (GB): spaces are preserved (they are significant)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Digits and letters"]}," (CA, NL, IE): special characters are stripped, letters are uppercased"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Digits and dashes"]}," (US, JP, BR, PL): dashes are preserved"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You do not need to sanitize postal codes before sending them to the API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"administrativearea-rules","__idx":4},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["administrativeArea"]}," rules"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Most European countries do not require ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["administrativeArea"]},". It is required for:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["North America:"]}," US (state), CA (province), MX (state)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["South America:"]}," BR (state), AR (province)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Asia Pacific:"]}," AU (state/territory), CN (province), JP (prefecture), MY (state), KR (province), ID (province), TH (province)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Europe:"]}," IT (province), ES (province), IE (county)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/developer-resources/ingrid-api/guides/address-form"},"children":["address form endpoint"]}," handles this — when"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["administrativeArea"]}," is required, it appears in the form layout with"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["required: true"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"street-and-number-order","__idx":5},"children":["Street and number order"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Most countries place the street name before the number (\"Sveavägen 1\"), but"," ","several place the number first (\"10 Downing Street\"):"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Number before street:"]}," AU, CA, FR, GB, IE, LU, US"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Street before number:"]}," SE, DE, NO, DK, FI, NL, AT, PL, ES, IT, and most others"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This affects how ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["addressLines[0]"]}," is formatted, but the API accepts either"," ","order for all countries."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-guides","__idx":6},"children":["Related guides"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/developer-resources/ingrid-api/guides/addresses"},"children":["Working with addresses"]}," — the address model and full flow"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/developer-resources/ingrid-api/guides/address-form"},"children":["Rendering the address form"]}," — dynamically render"," ","country-correct forms"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/developer-resources/ingrid-api/guides/address-validation"},"children":["Address validation"]}," — verify addresses before order"," ","creation"]}]}]},"headings":[{"value":"Country reference","id":"country-reference","depth":1},{"value":"Summary","id":"summary","depth":2},{"value":"Common patterns","id":"common-patterns","depth":2},{"value":"Postal code sanitization","id":"postal-code-sanitization","depth":3},{"value":"administrativeArea rules","id":"administrativearea-rules","depth":3},{"value":"Street and number order","id":"street-and-number-order","depth":3},{"value":"Related guides","id":"related-guides","depth":2}],"frontmatter":{"title":"Country Reference","description":"Country-specific address field requirements, postal code formats, and formatting rules","seo":{"title":"Country reference"}},"lastModified":"2026-02-24T19:14:57.409Z","pagePropGetterError":{"message":"","name":""}},"slug":"/developer-resources/ingrid-api/guides/country-reference","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}