{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-developer-resources/ingrid-api/guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Germany (DE)","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":"germany-de","__idx":0},"children":["Germany (DE)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Germany uses a 5-digit postal code (Postleitzahl) and places the street name"," ","before the house number. No state or region field is required."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"example","__idx":1},"children":["Example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"countryCode\": \"DE\",\n  \"postalCode\": \"10115\",\n  \"addressLines\": [\"Friedrichstraße 43\"],\n  \"locality\": \"Berlin\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"field-requirements","__idx":2},"children":["Field requirements"]},{"$$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":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["countryCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Always ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"DE\""]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["postalCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5 digits"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["addressLines"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes (for shipment)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Index 0: street name and house number"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["locality"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes (for shipment)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["City (Ort)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["administrativeArea"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Bundesland — not required for delivery"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subLocality"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ortsteil — rarely needed"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"postal-code","__idx":3},"children":["Postal code"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Format:"]}," Five consecutive digits"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Regex:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["^\\d{5}$"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Examples:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"10115\""]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"80331\""]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"20095\""]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sanitization:"]}," The API strips all non-digit characters"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["German postal codes always start with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]},"-",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["9"]},". Leading zeros are significant"," ","(e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"01067\""]}," for Dresden)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"address-lines","__idx":4},"children":["Address lines"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The street name comes ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["before"]}," the house number, without a comma."]},{"$$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":"Scenario"},"children":["Scenario"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"addressLines value"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["addressLines"]}," value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Standard"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[\"Friedrichstraße 43\"]"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["With apartment"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[\"Friedrichstraße 43\", \"3. OG links\"]"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["With c/o"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[\"Friedrichstraße 43\", \"c/o Müller\"]"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Floor and apartment information go on the second line"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["German conventions use abbreviations like ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["OG"]}," (Obergeschoss / upper floor),"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EG"]}," (Erdgeschoss / ground floor)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"locality","__idx":5},"children":["Locality"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["locality"]}," field is the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["city"]}," (Ort or Stadt)."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Berlin\""]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"München\""]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Hamburg\""]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The city can be pre-filled from the postal code using the"," ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/developer-resources/ingrid-api/guides/address-form"},"children":["address form endpoint"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"common-mistakes","__idx":6},"children":["Common mistakes"]},{"$$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":"Mistake"},"children":["Mistake"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Problem"},"children":["Problem"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Fix"},"children":["Fix"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"addressLines\": [\"43 Friedrichstraße\"]"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Number before street"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Germany uses street-first: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["[\"Friedrichstraße 43\"]"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"postalCode\": \"1115\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Missing leading zero"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Preserve leading zeros: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"01115\""]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"locality\": \"Freistaat Bayern\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Using state instead of city"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use the city name: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"München\""]}]}]}]}]}]}]},"headings":[{"value":"Germany (DE)","id":"germany-de","depth":1},{"value":"Example","id":"example","depth":2},{"value":"Field requirements","id":"field-requirements","depth":2},{"value":"Postal code","id":"postal-code","depth":2},{"value":"Address lines","id":"address-lines","depth":2},{"value":"Locality","id":"locality","depth":2},{"value":"Common mistakes","id":"common-mistakes","depth":2}],"frontmatter":{"title":"Germany (DE)","description":"Address requirements, postal code format, and field rules for Germany","seo":{"title":"Germany (DE)"}},"lastModified":"2026-02-24T19:14:57.409Z","pagePropGetterError":{"message":"","name":""}},"slug":"/developer-resources/ingrid-api/guides/country-reference/germany","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}