{"items":[{"type":"link","label":"Ingrid API","link":"/developer-resources/ingrid-api/openapi","routeSlug":"/developer-resources/ingrid-api/openapi","content":{"contentType":"overview","meta":{"name":"Ingrid API"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"openapi.json","url":"/_bundle/developer-resources/ingrid-api/@v1/openapi.json?download"},{"kind":"download","label":"openapi.yaml","url":"/_bundle/developer-resources/ingrid-api/@v1/openapi.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[{"kind":"email","title":"Ingrid Support","email":"support@ingrid.com","label":"support@ingrid.com","withCopyButton":true,"copyContent":"support@ingrid.com"},{"kind":"externallink","title":"License","titleTranslationKey":"info.license","label":"Apache 2.0","url":"https://www.apache.org/licenses/LICENSE-2.0"}]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"r","title":"R","lang":"R"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"/_mock/developer-resources/ingrid-api/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.ingrid.com","description":"Production"}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Ingrid API (1.0.0)","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":"The Ingrid API is organized around REST. Our API has predictable resource-oriented URLs, accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs. You can use the Ingrid API in test mode, which doesn't affect your live data or interact with carrier networks. The API key you use to authenticate the request determines whether the request is live mode or test mode."}],"sectionId":"/developer-resources/ingrid-api/openapi"}],"sectionId":"/developer-resources/ingrid-api/openapi"}]}]}},{"type":"separator","label":"Address","content":null},{"type":"group","label":"Address","link":"/developer-resources/ingrid-api/openapi/address","routeSlug":"/developer-resources/ingrid-api/openapi/address","items":[{"label":"Get form configuration","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/developer-resources/ingrid-api/openapi/address/getaddressform","routeSlug":"/developer-resources/ingrid-api/openapi/address/getaddressform","metadata":{"seo":{"title":"Get form configuration","description":"Get the localized address form configuration for a specific country."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getAddressForm","name":"Get form configuration","isWebhook":false,"pointer":"/paths/~1v1~1address~1form/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get form configuration","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get the localized address form configuration for a specific country."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns the form fields, validation logic, and visual layout for building"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"a localized address form dynamically on the client."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"address/getaddressform/request/localization","deepLinkHash":"/address/getaddressform#address/getaddressform/request/localization"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Localization"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"All human-readable strings in the response (field "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"label"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"s, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"hint"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"s"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"and "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"validationRules[].message"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"s) along with the resolved"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"meta.language"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" are translated according to the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Accept-Language"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" request"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"header. The server selects the best matching locale from the header's"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"quality-ranked list. When the header is absent or none of its locales are"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"supported, "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"en-US"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is used."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"address/getaddressform/request/server-driven-ui-(sdui)-pattern","deepLinkHash":"/address/getaddressform#address/getaddressform/request/server-driven-ui-(sdui)-pattern"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Server-Driven UI (SDUI) Pattern"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This endpoint uses a "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Server-Driven UI"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" pattern with a flat schema strategy"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"to avoid complex polymorphism. Clients must adhere to the following rules"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"when rendering:"},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"address/getaddressform/request/1.-layout-first-rendering","deepLinkHash":"/address/getaddressform#address/getaddressform/request/1.-layout-first-rendering"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"1. Layout-First Rendering"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Do not iterate through the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fields"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object directly. Iterate through the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"layout"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" array instead. The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"layout"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" determines the visual order and grouping"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"(rows/columns) of the inputs."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"address/getaddressform/request/2.-conditional-properties","deepLinkHash":"/address/getaddressform#address/getaddressform/request/2.-conditional-properties"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"2. Conditional Properties"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Because the schema is flat, the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"FieldDefinition"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object contains properties"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"that may not apply to the current "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"uiType"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":":"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"options"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": ALWAYS ignore unless "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"uiType === \"select\""},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"keyboard"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Ignore unless "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"uiType === \"text\""},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (mobile only)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"validationRules"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": If empty or absent, no regex validation is required — only"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"check the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" boolean"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":3,"id":"address/getaddressform/request/3.-state-management","deepLinkHash":"/address/getaddressform#address/getaddressform/request/3.-state-management"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"3. State Management"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If the user changes the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"countryCode"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" selection, the client "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"MUST"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" discard"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the current form configuration and fetch this endpoint again with the new"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"countryCode"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"Bearer"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"countryCode","in":"query","schemaId":"schema_55","description":"ISO 3166-1 alpha-2 country code (e.g., SE, US, GB).","required":true},{"name":"siteId","in":"query","schemaId":"schema_56","description":"Site identifier, referring to which site the form configurations are related to.","required":true},{"name":"postalCode","in":"query","schemaId":"schema_57","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Optional postal code. If provided, the response "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"values"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"may contain pre-filled city/state data."},"children":[]}]}]}]},{"name":"type","in":"query","schemaId":"schema_58","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Selects which form configuration to return. When omitted, the delivery"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"form is returned. Passing "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"billing"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" returns the site-configured billing"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"form for the country; if the site has no billing layout, the endpoint"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"responds with a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"BadRequestError"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}],"pointer":"/paths/~1v1~1address~1form/get/parameters"},{"nodeType":"item-content","variant":"headers","label":"Headers","labelTranslationKey":"header","parameters":[{"name":"Accept-Language","in":"header","schemaId":"schema_57","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Selects the locale of the localized, human-readable parts of the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"response. When omitted, the endpoint's default locale applies, falling"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"back to "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"en-US"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}],"pointer":"/paths/~1v1~1address~1form/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/address/form","servers":[{"url":"/_mock/developer-resources/ingrid-api/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.ingrid.com","description":"Production"}],"parameters":{"path":[],"query":[{"name":"countryCode","in":"query","required":true,"schemaId":"components/schemas/Address.CountryCode","explode":false},{"name":"siteId","in":"query","required":true,"schemaId":"components/schemas/Address.SiteId","explode":false},{"name":"postalCode","in":"query","required":false,"schemaId":"schema_57","explode":false},{"name":"type","in":"query","required":false,"schemaId":"components/schemas/Address.FormType","explode":false}],"querystring":[],"header":[{"name":"Accept-Language","in":"header","required":false,"schemaId":"schema_57"}],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"Bearer"}],"scopes":[]}],"responseCodes":["200","400","500"],"pointer":"/v1/address/form","href":"address/getaddressform","openApiOperationId":"getAddressForm","summary":"Get form configuration"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/developer-resources/ingrid-api/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.ingrid.com","description":"Production"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A response whose body is localized through "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"Accept-Language"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Address.AddressFormResponse","exampleIds":["paths/~1v1~1address~1form/get/responses/200/content/application~1json/examples/Norwegian address form with postal code lookup","paths/~1v1~1address~1form/get/responses/200/content/application~1json/examples/German address form with postal code lookup","paths/~1v1~1address~1form/get/responses/200/content/application~1json/examples/Swedish address form with postal code lookup"]}},"schemaId":"components/schemas/Address.AddressFormResponse","exampleIds":["paths/~1v1~1address~1form/get/responses/200/content/application~1json/examples/Norwegian address form with postal code lookup","paths/~1v1~1address~1form/get/responses/200/content/application~1json/examples/German address form with postal code lookup","paths/~1v1~1address~1form/get/responses/200/content/application~1json/examples/Swedish address form with postal code lookup"],"headers":{"Vary":{"required":true,"schema":{"type":"string","enum":["Accept-Language"]}}},"headerSchemaId":"schema_59"},{"code":"400","description":"The server could not understand the request due to invalid syntax.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Common.Errors.BadRequestError"}},"schemaId":"components/schemas/Common.Errors.BadRequestError"},{"code":"500","description":"Server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Common.Errors.ServerError"}},"schemaId":"components/schemas/Common.Errors.ServerError"}],"pointer":"/paths/~1v1~1address~1form/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Address.AddressFormResponse","exampleIds":["paths/~1v1~1address~1form/get/responses/200/content/application~1json/examples/Norwegian address form with postal code lookup","paths/~1v1~1address~1form/get/responses/200/content/application~1json/examples/German address form with postal code lookup","paths/~1v1~1address~1form/get/responses/200/content/application~1json/examples/Swedish address form with postal code lookup"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Address.AddressFormResponse","exampleIds":["paths/~1v1~1address~1form/get/responses/200/content/application~1json/examples/Norwegian address form with postal code lookup","paths/~1v1~1address~1form/get/responses/200/content/application~1json/examples/German address form with postal code lookup","paths/~1v1~1address~1form/get/responses/200/content/application~1json/examples/Swedish address form with postal code lookup"]}}},{"code":"400","schemaId":"components/schemas/Common.Errors.BadRequestError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Common.Errors.BadRequestError"}}},{"code":"500","schemaId":"components/schemas/Common.Errors.ServerError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Common.Errors.ServerError"}}}],"examples":[]}]}]}]},"httpPath":"/v1/address/form"},{"label":"Search","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/developer-resources/ingrid-api/openapi/address/autocompleteaddress","routeSlug":"/developer-resources/ingrid-api/openapi/address/autocompleteaddress","metadata":{"seo":{"title":"Search","description":"Search for addresses or expand a container to drill down into child results."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"autocompleteAddress","name":"Search","isWebhook":false,"pointer":"/paths/~1v1~1address~1search/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Search","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Search for addresses or expand a container to drill down into child results."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Returns a list of address predictions based on the user's text input or"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"hierarchical container expansion."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"address/autocompleteaddress/request/the-\"expand-vs-resolve\"-pattern","deepLinkHash":"/address/autocompleteaddress#address/autocompleteaddress/request/the-\"expand-vs-resolve\"-pattern"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The \"Expand vs Resolve\" Pattern"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Each prediction in the response has an "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field that determines"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the next step:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resolve"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": The prediction is a final address. Call"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"GET /v1/address/details/{id}"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with the prediction's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"get the full address."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expand"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": The prediction is a container (e.g., a building with"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"multiple units). Call this endpoint again with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"containerId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" set to the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"prediction's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" to fetch the children."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"address/autocompleteaddress/request/usage-modes","deepLinkHash":"/address/autocompleteaddress#address/autocompleteaddress/request/usage-modes"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Usage Modes"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":true,"marker":"."},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Text Search"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Provide "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"query"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" with the user's typed text. Results"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"are ranked by relevance."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Container Drill-Down"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Provide "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"containerId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" from a previous"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"prediction (where "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" was "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expand"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"). The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"query"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter is"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ignored in this mode."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Field-Specific Search"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Use the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"focus"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" parameter to optimize"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"results for the field being edited (e.g., "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"postalCode"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" triggers postal"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"database lookups in supported countries)."},"children":[]}]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"Bearer"}]}]},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"countryCode","in":"query","schemaId":"schema_55","description":"ISO 3166-1 alpha-2 country code.","required":true},{"name":"siteId","in":"query","schemaId":"schema_56","description":"Site identifier, referring to which site the autocompletion is performed for.","required":true},{"name":"query","in":"query","schemaId":"schema_57","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The text typed by the user. Ignored if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"containerId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is provided."},"children":[]}]}]}]},{"name":"containerId","in":"query","schemaId":"schema_57","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The ID of a parent result (where "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" was "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expand"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Used to fetch children (e.g., units in a building)."},"children":[]}]}]}]},{"name":"focus","in":"query","schemaId":"schema_60","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The field the user is currently editing. Helps the API optimize results."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"For example, if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"focus"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"postalCode"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" and the country is GB, the API"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"searches the PAF database."},"children":[]}]}]}]}],"pointer":"/paths/~1v1~1address~1search/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/address/search","servers":[{"url":"/_mock/developer-resources/ingrid-api/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.ingrid.com","description":"Production"}],"parameters":{"path":[],"query":[{"name":"countryCode","in":"query","required":true,"schemaId":"components/schemas/Address.CountryCode","explode":false},{"name":"siteId","in":"query","required":true,"schemaId":"components/schemas/Address.SiteId","explode":false},{"name":"query","in":"query","required":false,"schemaId":"schema_57","explode":false},{"name":"containerId","in":"query","required":false,"schemaId":"schema_57","explode":false},{"name":"focus","in":"query","required":false,"schemaId":"components/schemas/Address.AutocompleteFocus","explode":false}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"Bearer"}],"scopes":[]}],"responseCodes":["200","400","500"],"pointer":"/v1/address/search","href":"address/autocompleteaddress","openApiOperationId":"autocompleteAddress","summary":"Search"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/developer-resources/ingrid-api/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.ingrid.com","description":"Production"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The request has succeeded.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Address.SearchAddressesResponse","exampleIds":["paths/~1v1~1address~1search/get/responses/200/content/application~1json/examples/Text search for Dutch addresses","paths/~1v1~1address~1search/get/responses/200/content/application~1json/examples/Text search for German addresses","paths/~1v1~1address~1search/get/responses/200/content/application~1json/examples/Expand a street container","paths/~1v1~1address~1search/get/responses/200/content/application~1json/examples/Text search for UK addresses"]}},"schemaId":"components/schemas/Address.SearchAddressesResponse","exampleIds":["paths/~1v1~1address~1search/get/responses/200/content/application~1json/examples/Text search for Dutch addresses","paths/~1v1~1address~1search/get/responses/200/content/application~1json/examples/Text search for German addresses","paths/~1v1~1address~1search/get/responses/200/content/application~1json/examples/Expand a street container","paths/~1v1~1address~1search/get/responses/200/content/application~1json/examples/Text search for UK addresses"]},{"code":"400","description":"The server could not understand the request due to invalid syntax.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Common.Errors.BadRequestError"}},"schemaId":"components/schemas/Common.Errors.BadRequestError"},{"code":"500","description":"Server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Common.Errors.ServerError"}},"schemaId":"components/schemas/Common.Errors.ServerError"}],"pointer":"/paths/~1v1~1address~1search/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Address.SearchAddressesResponse","exampleIds":["paths/~1v1~1address~1search/get/responses/200/content/application~1json/examples/Text search for Dutch addresses","paths/~1v1~1address~1search/get/responses/200/content/application~1json/examples/Text search for German addresses","paths/~1v1~1address~1search/get/responses/200/content/application~1json/examples/Expand a street container","paths/~1v1~1address~1search/get/responses/200/content/application~1json/examples/Text search for UK addresses"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Address.SearchAddressesResponse","exampleIds":["paths/~1v1~1address~1search/get/responses/200/content/application~1json/examples/Text search for Dutch addresses","paths/~1v1~1address~1search/get/responses/200/content/application~1json/examples/Text search for German addresses","paths/~1v1~1address~1search/get/responses/200/content/application~1json/examples/Expand a street container","paths/~1v1~1address~1search/get/responses/200/content/application~1json/examples/Text search for UK addresses"]}}},{"code":"400","schemaId":"components/schemas/Common.Errors.BadRequestError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Common.Errors.BadRequestError"}}},{"code":"500","schemaId":"components/schemas/Common.Errors.ServerError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Common.Errors.ServerError"}}}],"examples":[]}]}]}]},"httpPath":"/v1/address/search"},{"label":"Get details","deprecated":false,"httpVerb":"get","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/developer-resources/ingrid-api/openapi/address/getaddressdetails","routeSlug":"/developer-resources/ingrid-api/openapi/address/getaddressdetails","metadata":{"seo":{"title":"Get details","description":"Get the full address details for a prediction."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"getAddressDetails","name":"Get details","isWebhook":false,"pointer":"/paths/~1v1~1address~1details~1{id}/get","hasSamples":false},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Get details","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Get the full address details for a prediction."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Exchanges a prediction ID (where "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" was "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resolve"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") for a full,"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"formatted address object that can be used to populate the"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"address form fields."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This is the second step of the autocomplete flow — called after the user"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"selects a final address prediction from the autocomplete results."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"Bearer"}]}]},{"nodeType":"item-content","variant":"path","label":"Path","labelTranslationKey":"path","parameters":[{"name":"id","in":"path","schemaId":"schema_57","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The opaque identifier from a prediction (where "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" was "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resolve"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"required":true}],"pointer":"/paths/~1v1~1address~1details~1{id}/get/parameters"},{"nodeType":"item-content","variant":"query","label":"Query","labelTranslationKey":"query","parameters":[{"name":"siteId","in":"query","schemaId":"schema_56","description":"Site identifier, referring to which site the address is resolved for.","required":true}],"pointer":"/paths/~1v1~1address~1details~1{id}/get/parameters"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"GET","path":"/v1/address/details/{id}","servers":[{"url":"/_mock/developer-resources/ingrid-api/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.ingrid.com","description":"Production"}],"parameters":{"path":[{"name":"id","in":"path","required":true,"schemaId":"schema_57"}],"query":[{"name":"siteId","in":"query","required":true,"schemaId":"components/schemas/Address.SiteId","explode":false}],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"Bearer"}],"scopes":[]}],"responseCodes":["200","400","404","500"],"pointer":"/v1/address/details/{id}","href":"address/getaddressdetails","openApiOperationId":"getAddressDetails","summary":"Get details"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/developer-resources/ingrid-api/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.ingrid.com","description":"Production"}],"examples":[]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The request has succeeded.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Address.AddressDetailsResponse","exampleIds":["paths/~1v1~1address~1details~1{id}/get/responses/200/content/application~1json/examples/Resolve a French address prediction","paths/~1v1~1address~1details~1{id}/get/responses/200/content/application~1json/examples/Resolve a German address prediction","paths/~1v1~1address~1details~1{id}/get/responses/200/content/application~1json/examples/Resolve a UK address prediction"]}},"schemaId":"components/schemas/Address.AddressDetailsResponse","exampleIds":["paths/~1v1~1address~1details~1{id}/get/responses/200/content/application~1json/examples/Resolve a French address prediction","paths/~1v1~1address~1details~1{id}/get/responses/200/content/application~1json/examples/Resolve a German address prediction","paths/~1v1~1address~1details~1{id}/get/responses/200/content/application~1json/examples/Resolve a UK address prediction"]},{"code":"400","description":"The server could not understand the request due to invalid syntax.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Common.Errors.BadRequestError"}},"schemaId":"components/schemas/Common.Errors.BadRequestError"},{"code":"404","description":"The server cannot find the requested resource.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Common.Errors.NotFoundError"}},"schemaId":"components/schemas/Common.Errors.NotFoundError"},{"code":"500","description":"Server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Common.Errors.ServerError"}},"schemaId":"components/schemas/Common.Errors.ServerError"}],"pointer":"/paths/~1v1~1address~1details~1{id}/get/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Address.AddressDetailsResponse","exampleIds":["paths/~1v1~1address~1details~1{id}/get/responses/200/content/application~1json/examples/Resolve a French address prediction","paths/~1v1~1address~1details~1{id}/get/responses/200/content/application~1json/examples/Resolve a German address prediction","paths/~1v1~1address~1details~1{id}/get/responses/200/content/application~1json/examples/Resolve a UK address prediction"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Address.AddressDetailsResponse","exampleIds":["paths/~1v1~1address~1details~1{id}/get/responses/200/content/application~1json/examples/Resolve a French address prediction","paths/~1v1~1address~1details~1{id}/get/responses/200/content/application~1json/examples/Resolve a German address prediction","paths/~1v1~1address~1details~1{id}/get/responses/200/content/application~1json/examples/Resolve a UK address prediction"]}}},{"code":"400","schemaId":"components/schemas/Common.Errors.BadRequestError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Common.Errors.BadRequestError"}}},{"code":"404","schemaId":"components/schemas/Common.Errors.NotFoundError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Common.Errors.NotFoundError"}}},{"code":"500","schemaId":"components/schemas/Common.Errors.ServerError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Common.Errors.ServerError"}}}],"examples":[]}]}]}]},"httpPath":"/v1/address/details/{id}"},{"label":"Verify and standardize","deprecated":false,"httpVerb":"post","isAdditionalOperation":false,"isWebhook":false,"type":"link","link":"/developer-resources/ingrid-api/openapi/address/validateaddress","routeSlug":"/developer-resources/ingrid-api/openapi/address/validateaddress","metadata":{"seo":{"title":"Verify and standardize","description":"Verify and standardize an address."}},"content":{"contentType":"item","itemVariant":"httpItem","meta":{"sourceId":"validateAddress","name":"Verify and standardize","isWebhook":false,"pointer":"/paths/~1v1~1address~1validate/post","hasSamples":true},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Verify and standardize","isWebhook":false,"showPageActions":true}],"panels":[]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Request","labelTranslationKey":"request","deepLinkSuffix":"request"},{"nodeType":"markdoc","content":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Verify and standardize an address."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Takes a raw address object, matches it against official postal reference"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"data (e.g., USPS, PostNord, Royal Mail), and returns a cleaned, verified"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"version along with quality analysis."},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"address/validateaddress/request/response-handling","deepLinkHash":"/address/validateaddress#address/validateaddress/request/response-handling"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Response Handling"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" field acts as a traffic light for UI logic:"},"children":[]}]}]},{"$$mdtype":"Node","type":"table","attributes":{},"children":[{"$$mdtype":"Node","type":"thead","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Status"},"children":[]}]}]},{"$$mdtype":"Node","type":"th","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Action"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"tbody","attributes":{},"children":[{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"valid"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"High confidence match. Save the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"candidate"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" address automatically."},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"suspect"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Match found with significant changes. Prompt the user: \"Did you mean...?\""},"children":[]}]}]}]},{"$$mdtype":"Node","type":"tr","attributes":{},"children":[{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"invalid"},"children":[]}]}]},{"$$mdtype":"Node","type":"td","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"No deliverable address found. Block form submission."},"children":[]}]}]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":2,"id":"address/validateaddress/request/field-reports","deepLinkHash":"/address/validateaddress#address/validateaddress/request/field-reports"},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Field Reports"},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The optional "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fieldReports"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" dictionary provides per-field status that can"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"be used to highlight specific inputs in the UI (e.g., a red border around"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"the postal code field if it was corrected or invalid)."},"children":[]}]}]}]},{"nodeType":"security","requirements":[{"schemes":[{"name":"BearerAuth","scopes":[],"type":"http","scheme":"Bearer"}]}]},{"nodeType":"item-content","variant":"body","label":"Request Body","labelTranslationKey":"body","required":true,"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/Address.ValidateAddressRequest","exampleIds":["paths/~1v1~1address~1validate/post/requestBody/content/application~1json/examples/Validate an Italian address with postal code correction","paths/~1v1~1address~1validate/post/requestBody/content/application~1json/examples/Validate a correct German address","paths/~1v1~1address~1validate/post/requestBody/content/application~1json/examples/Validate a Swedish address with corrections"]}},"schemaId":"components/schemas/Address.ValidateAddressRequest","exampleIds":["paths/~1v1~1address~1validate/post/requestBody/content/application~1json/examples/Validate an Italian address with postal code correction","paths/~1v1~1address~1validate/post/requestBody/content/application~1json/examples/Validate a correct German address","paths/~1v1~1address~1validate/post/requestBody/content/application~1json/examples/Validate a Swedish address with corrections"],"pointer":"/paths/~1v1~1address~1validate/post/requestBody"}],"panels":[{"children":[{"kind":"code-sample","source":{"kind":"code-sample","operationType":"http","method":"POST","path":"/v1/address/validate","servers":[{"url":"/_mock/developer-resources/ingrid-api/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.ingrid.com","description":"Production"}],"parameters":{"path":[],"query":[],"querystring":[],"header":[],"cookie":[]},"security":[{"schemes":[{"id":"BearerAuth","type":"http","scheme":"Bearer"}],"scopes":[]}],"requestBody":{"application/json":{"schemaId":"components/schemas/Address.ValidateAddressRequest","exampleIds":["paths/~1v1~1address~1validate/post/requestBody/content/application~1json/examples/Validate an Italian address with postal code correction","paths/~1v1~1address~1validate/post/requestBody/content/application~1json/examples/Validate a correct German address","paths/~1v1~1address~1validate/post/requestBody/content/application~1json/examples/Validate a Swedish address with corrections"]}},"responseCodes":["200","400","500"],"pointer":"/v1/address/validate","href":"address/validateaddress","openApiOperationId":"validateAddress","summary":"Verify and standardize"},"isWebhook":false,"hideReplay":false,"servers":[{"url":"/_mock/developer-resources/ingrid-api/openapi","description":"Mock server","isMockServer":true},{"url":"https://api.ingrid.com","description":"Production"}],"schemaId":"components/schemas/Address.ValidateAddressRequest","exampleIds":["paths/~1v1~1address~1validate/post/requestBody/content/application~1json/examples/Validate an Italian address with postal code correction","paths/~1v1~1address~1validate/post/requestBody/content/application~1json/examples/Validate a correct German address","paths/~1v1~1address~1validate/post/requestBody/content/application~1json/examples/Validate a Swedish address with corrections"],"mediaTypes":["application/json"],"mediaTypeSchemas":{"application/json":{"schemaId":"components/schemas/Address.ValidateAddressRequest","exampleIds":["paths/~1v1~1address~1validate/post/requestBody/content/application~1json/examples/Validate an Italian address with postal code correction","paths/~1v1~1address~1validate/post/requestBody/content/application~1json/examples/Validate a correct German address","paths/~1v1~1address~1validate/post/requestBody/content/application~1json/examples/Validate a Swedish address with corrections"]}},"examples":[{},{},{}]}]}]},{"nodeType":"container","children":[{"nodeType":"header","level":4,"label":"Responses","labelTranslationKey":"responses","deepLinkSuffix":"responses"},{"nodeType":"item-content","variant":"responses","responses":[{"code":"200","description":"The request has succeeded.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Address.ValidationResult","exampleIds":["paths/~1v1~1address~1validate/post/responses/200/content/application~1json/examples/Validate an Italian address with postal code correction","paths/~1v1~1address~1validate/post/responses/200/content/application~1json/examples/Validate a correct German address","paths/~1v1~1address~1validate/post/responses/200/content/application~1json/examples/Validate a Swedish address with corrections"]}},"schemaId":"components/schemas/Address.ValidationResult","exampleIds":["paths/~1v1~1address~1validate/post/responses/200/content/application~1json/examples/Validate an Italian address with postal code correction","paths/~1v1~1address~1validate/post/responses/200/content/application~1json/examples/Validate a correct German address","paths/~1v1~1address~1validate/post/responses/200/content/application~1json/examples/Validate a Swedish address with corrections"]},{"code":"400","description":"The server could not understand the request due to invalid syntax.","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Common.Errors.BadRequestError"}},"schemaId":"components/schemas/Common.Errors.BadRequestError"},{"code":"500","description":"Server error","mediaType":"application/json","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Common.Errors.ServerError"}},"schemaId":"components/schemas/Common.Errors.ServerError"}],"pointer":"/paths/~1v1~1address~1validate/post/responses"}],"panels":[{"children":[{"kind":"response","responseCodes":[{"code":"200","schemaId":"components/schemas/Address.ValidationResult","exampleIds":["paths/~1v1~1address~1validate/post/responses/200/content/application~1json/examples/Validate an Italian address with postal code correction","paths/~1v1~1address~1validate/post/responses/200/content/application~1json/examples/Validate a correct German address","paths/~1v1~1address~1validate/post/responses/200/content/application~1json/examples/Validate a Swedish address with corrections"],"mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Address.ValidationResult","exampleIds":["paths/~1v1~1address~1validate/post/responses/200/content/application~1json/examples/Validate an Italian address with postal code correction","paths/~1v1~1address~1validate/post/responses/200/content/application~1json/examples/Validate a correct German address","paths/~1v1~1address~1validate/post/responses/200/content/application~1json/examples/Validate a Swedish address with corrections"]}}},{"code":"400","schemaId":"components/schemas/Common.Errors.BadRequestError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Common.Errors.BadRequestError"}}},{"code":"500","schemaId":"components/schemas/Common.Errors.ServerError","mediaTypes":["application/json"],"mediaTypeContent":{"application/json":{"schemaId":"components/schemas/Common.Errors.ServerError"}}}],"examples":[]}]}]}]},"httpPath":"/v1/address/validate"}],"content":{"contentType":"group","meta":{"name":"Address"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Address","showPageActions":true},{"nodeType":"markdoc","content":"Address API"}],"panels":[{"children":[{"kind":"group-items","title":"Operations","titleTranslationKey":"operations","items":[{"title":"/v1/address/form","summary":"Get form configuration","prefix":{"name":"get","color":"get"},"badges":[],"link":"/address/getaddressform","deprecated":false},{"title":"/v1/address/search","summary":"Search","prefix":{"name":"get","color":"get"},"badges":[],"link":"/address/autocompleteaddress","deprecated":false},{"title":"/v1/address/details/{id}","summary":"Get details","prefix":{"name":"get","color":"get"},"badges":[],"link":"/address/getaddressdetails","deprecated":false},{"title":"/v1/address/validate","summary":"Verify and standardize","prefix":{"name":"post","color":"post"},"badges":[],"link":"/address/validateaddress","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/Address.Address":{"id":"components/schemas/Address.Address","kind":"json-schema","title":"Address.Address","data":{"type":"object","required":["countryCode","postalCode"],"properties":{"countryCode":{"$ref":"#/components/schemas/Address.CountryCode","description":"ISO 3166-1 alpha-2 country code."},"postalCode":{"type":"string","description":"Postal code.\nFormatting and validation rules are conditional and based on the country code.","examples":["1017 DR","75001","10117","12345"]},"administrativeArea":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Required for countries:"},"children":[]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":5},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"North America"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"US"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (United States) - "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"State"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"CA"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (Canada) - "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Province/Territory"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"MX"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (Mexico) - "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"State (Estado)"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":5},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"South America"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"BR"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (Brazil) - "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"State (Estado)"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"AR"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (Argentina) - "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Province"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":5},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Asia Pacific"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"AU"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (Australia) - "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"State/Territory"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"CN"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (China) - "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Province"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"JP"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (Japan) - "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Prefecture"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"MY"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (Malaysia) - "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"State"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"KR"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (South Korea) - "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Province/City-Province"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ID"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (Indonesia) - "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Province"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"TH"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (Thailand) - "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Province (Changwat)"},"children":[]}]}]}]}]},{"$$mdtype":"Node","type":"heading","attributes":{"level":5},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Europe"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"*"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"IT"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (Italy) - "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Province"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (2-letter abbreviation like MI, RM)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"ES"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (Spain) - "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Province"},"children":[]}]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"IE"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (Ireland) - "},"children":[]},{"$$mdtype":"Node","type":"em","inline":true,"attributes":{"marker":"*"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"County"},"children":[]}]}]}]}]}],"examples":["RM","Stockholms län"]},"subAdministrativeArea":{"type":"string","description":"Usually the District, Suburb, or Neighborhood.\nTypically not required unless explicitly specified in our documentation."},"locality":{"type":"string","description":"The primary locality of the address.\nUsually the City, Town, Village, or Municipality.","examples":["Paris","Amsterdam","Berlin","San Francisco","Stockholm"]},"subLocality":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The neighborhood, suburb, or district within the locality."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Typically not required unless explicitly specified in our documentation."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Critical for:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Japan (chome/district names)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"UK (London districts like \"Soho\" or \"Brixton\")"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Latin America (colonia)"},"children":[]}]}]}]}]},"addressLines":{"type":"array","items":{"type":"string"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"An ordered array of street address lines."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Index 0: Primary street info (Street name + Number, or Block number)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Index 1+: Secondary info (Apartment, Suite, Floor, Building Name)."},"children":[]}]}]}],"examples":[["Keizersgracht 585"],["15 Rue de Rivoli"],["Friedrichstraße 43"],["Gatan 1","1602"],["123 Market Street","Floor 2, Apt 4B"],["Sveavägen 1"]]},"type":{"$ref":"#/components/schemas/Address.AddressType"}},"description":"Represents a physical location in a global context.\nDesigned to be generic enough for international addressing standards\n\nValidation is conditional and based on the country code."}},"components/schemas/Address.AddressChange":{"id":"components/schemas/Address.AddressChange","kind":"json-schema","title":"Address.AddressChange","data":{"type":"string","enum":["postalCodeFixed","localityFixed","spellingCorrected","componentsAdded","componentsRemoved"],"description":"Types of modifications the validation API made to the original address."}},"components/schemas/Address.AddressDetailsResponse":{"id":"components/schemas/Address.AddressDetailsResponse","kind":"json-schema","title":"Address.AddressDetailsResponse","data":{"type":"object","required":["address"],"properties":{"address":{"$ref":"#/components/schemas/Address.Address","description":"The full address resolved from the prediction."}},"description":"Response containing the full address resolved from a prediction ID."}},"components/schemas/Address.AddressFormResponse":{"id":"components/schemas/Address.AddressFormResponse","kind":"json-schema","title":"Address.AddressFormResponse","data":{"type":"object","required":["meta","fields","layout"],"properties":{"meta":{"$ref":"#/components/schemas/Address.FormMeta","description":"Metadata about the form configuration including locale and text direction."},"values":{"type":"object","unevaluatedProperties":{"type":"string"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Pre-filled values for the form fields."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Keys correspond to the keys in the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"fields"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" object."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This is often populated if a "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"postalCode"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" was sent in the request."},"children":[]}]}]}]},"fields":{"type":"object","unevaluatedProperties":{"$ref":"#/components/schemas/Address.FieldDefinition"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Dictionary defining the behavior of each input field."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Keys are unique field identifiers (e.g., "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"postalCode"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"locality"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}]},"layout":{"type":"array","items":{"type":"array","items":{"type":"string"}},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Defines the visual grid of the form."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Clients should loop through this array to render the UI."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Outer array: Rows (stack vertically)"},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Inner array: Columns (stack horizontally / flex)"},"children":[]}]}]}]}],"examples":[[["recipientName"],["addressLines"],["postalCode","locality"]]]}},"description":"Response containing the complete form configuration for a localized address form.\nIncludes field definitions, validation rules, and visual layout instructions."}},"components/schemas/Address.AddressType":{"id":"components/schemas/Address.AddressType","kind":"json-schema","title":"Address.AddressType","data":{"type":"string","enum":["unknown","residential","commercial"]}},"components/schemas/Address.AutocompleteFocus":{"id":"components/schemas/Address.AutocompleteFocus","kind":"json-schema","title":"Address.AutocompleteFocus","data":{"type":"string","enum":["addressLines","postalCode","locality","administrativeArea"],"description":"Indicates which address field the user is currently editing.\nHelps the API optimize results for the relevant field context."}},"components/schemas/Address.CountryCode":{"id":"components/schemas/Address.CountryCode","kind":"json-schema","title":"Address.CountryCode","data":{"type":"string","pattern":"^[A-Z]{2}$","description":"Uppercase ISO 3166-1 alpha-2 country code.","examples":["NO","ES","IT","NL","FR","DE","US","SE"]}},"components/schemas/Address.FieldDefinition":{"id":"components/schemas/Address.FieldDefinition","kind":"json-schema","title":"Address.FieldDefinition","data":{"type":"object","required":["label","required","uiType"],"properties":{"label":{"type":"string","description":"Localized label text to display above the input.","examples":["City","Postnummer"]},"required":{"type":"boolean","description":"Whether the client must block submission if this field is empty."},"uiType":{"$ref":"#/components/schemas/Address.FieldUIType","description":"Determines the UI component to render."},"hint":{"type":"string","description":"Placeholder text (watermark) inside the input.","examples":["123 45"]},"keyboard":{"$ref":"#/components/schemas/Address.KeyboardType","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Hint for the virtual keyboard type (mobile only)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Ignore this field if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"uiType"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"select"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},"autocomplete":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"HTML5 autocomplete attribute value (e.g., "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"postal-code"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"address-level1"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Essential for browser autofill support."},"children":[]}]}]}],"examples":["address-level1","postal-code"]},"prefix":{"type":"string","description":"Static text prepended to the user's input before submission.","examples":["Våning ","LGH ","c/o "]},"suffix":{"type":"string","description":"Static text appended to the user's input before submission.","examples":[". Etage","F"]},"validationRules":{"type":"array","items":{"$ref":"#/components/schemas/Address.FieldValidationRule"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Validation rules for client-side validation."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If empty or absent, perform no regex validation — only check the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"required"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" boolean."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If present, validate each rule on blur/submit. All rules must pass for the field to be valid."},"children":[]}]}]}]},"options":{"type":"array","items":{"$ref":"#/components/schemas/Address.SelectOption"},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Items for a dropdown/picker."},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"uiType"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"select"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": This array contains the dropdown items."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"uiType"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"text"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"hidden"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": The client "},"children":[]},{"$$mdtype":"Node","type":"strong","inline":true,"attributes":{"marker":"**"},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"MUST IGNORE"},"children":[]}]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" this array."},"children":[]}]}]}]}]}},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Defines the properties of a single form input."},"children":[]}]}]},{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This object is permissive by design (flat schema strategy)."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Properties like "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"options"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"keyboard"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" exist on all fields"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"but should be ignored by the client based on the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"uiType"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}],"examples":[{"label":"Postleitzahl","required":true,"uiType":"text","keyboard":"numeric","autocomplete":"postal-code","validationRules":[{"regex":"^\\d{5}$","message":"Bitte geben Sie eine gültige Postleitzahl ein (5 Ziffern)"}],"hint":"10117"},{"label":"Postnummer","required":true,"uiType":"text","keyboard":"numeric","autocomplete":"postal-code","validationRules":[{"regex":"^\\d{3}\\s?\\d{2}$","message":"Ange ett giltigt postnummer (5 siffror)"}],"hint":"123 45"}]}},"components/schemas/Address.FieldReportStatus":{"id":"components/schemas/Address.FieldReportStatus","kind":"json-schema","title":"Address.FieldReportStatus","data":{"type":"string","enum":["match","fixed","missing","invalid","unknown"],"description":"Per-field validation status, useful for highlighting specific inputs in the UI."}},"components/schemas/Address.FieldUIType":{"id":"components/schemas/Address.FieldUIType","kind":"json-schema","title":"Address.FieldUIType","data":{"type":"string","enum":["text","select","hidden"],"description":"Determines the UI component to render for a form field."}},"components/schemas/Address.FieldValidationRule":{"id":"components/schemas/Address.FieldValidationRule","kind":"json-schema","title":"Address.FieldValidationRule","data":{"type":"object","required":["regex","message"],"properties":{"regex":{"type":"string","description":"Regex string for client-side validation.\nValidate on blur/submit.","examples":["^\\d{5}$","^\\d{3}\\s?\\d{2}$"]},"message":{"type":"string","description":"Localized error message to show if the regex validation fails.","examples":["Bitte geben Sie eine gültige Postleitzahl ein (5 Ziffern)","Ange ett giltigt postnummer (5 siffror)"]}},"description":"A single validation rule for a form field, consisting of a regex pattern and a localized error message."}},"components/schemas/Address.FormMeta":{"id":"components/schemas/Address.FormMeta","kind":"json-schema","title":"Address.FormMeta","data":{"type":"object","required":["countryCode","direction","language"],"properties":{"countryCode":{"$ref":"#/components/schemas/Address.CountryCode","description":"ISO 3166-1 alpha-2 country code for this form configuration."},"direction":{"$ref":"#/components/schemas/Address.TextDirection","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Text direction. "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"rtl"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (Right-to-Left) is critical for"},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"languages like Arabic or Hebrew."},"children":[]}]}]}]},"language":{"type":"string","description":"IETF language tag for the localized labels.","examples":["fr-FR","nb-NO","de-DE","ar-SA","en-US","sv-SE"]}},"description":"Metadata about the form configuration."}},"components/schemas/Address.FormType":{"id":"components/schemas/Address.FormType","kind":"json-schema","title":"Address.FormType","data":{"type":"string","enum":["delivery","billing"],"description":"Selects which address form configuration to return."}},"components/schemas/Address.KeyboardType":{"id":"components/schemas/Address.KeyboardType","kind":"json-schema","title":"Address.KeyboardType","data":{"type":"string","enum":["default","numeric","email","phone"],"description":"Hint for the virtual keyboard type on mobile devices."}},"components/schemas/Address.Prediction":{"id":"components/schemas/Address.Prediction","kind":"json-schema","title":"Address.Prediction","data":{"type":"object","required":["id","label","action"],"properties":{"id":{"type":"string","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Opaque identifier. Passed to the details endpoint (if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resolve"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":") or back to the autocomplete endpoint as "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"containerId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" (if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expand"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":")."},"children":[]}]}]}],"examples":["grp_street_882","addr_gbr_10045832"]},"label":{"type":"string","description":"Primary display text (e.g., \"Buckingham Road\").","examples":["Buckingham Road","10 Buckingham Road"]},"secondaryLabel":{"type":"string","description":"Secondary display text providing additional context (e.g., \"Redcar, TS10 3JQ\").","examples":["Redcar, TS10 3JQ"]},"action":{"$ref":"#/components/schemas/Address.PredictionAction","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Indicates the client action when the user selects this prediction:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"resolve"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Leaf node. Call the details endpoint with this prediction's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expand"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Container node. Call the autocomplete endpoint with "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"containerId"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" set to this prediction's "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"id"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]}]},"count":{"type":"integer","format":"int32","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"If "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"action"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"expand"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":", indicates how many child results are inside this container."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Useful for UI badges (e.g., \"60 Addresses\")."},"children":[]}]}]}],"examples":[60]},"type":{"$ref":"#/components/schemas/Address.PredictionType","description":"Semantic type of the result, useful for icon selection in the UI."}},"description":"A single address prediction returned by the autocomplete endpoint.","examples":[{"id":"grp_street_fr_1201","label":"Rue de Rivoli","secondaryLabel":"Paris, 75001","action":"expand","count":120,"type":"street"},{"id":"addr_deu_30198765","label":"Friedrichstraße 43","secondaryLabel":"Berlin, 10117","action":"resolve","type":"streetAddress"},{"id":"grp_street_882","label":"Buckingham Road","secondaryLabel":"Redcar, TS10","action":"expand","count":60,"type":"street"},{"id":"addr_gbr_10045832","label":"10 Buckingham Road","secondaryLabel":"Redcar, TS10 3JQ","action":"resolve","type":"streetAddress"}]}},"components/schemas/Address.PredictionAction":{"id":"components/schemas/Address.PredictionAction","kind":"json-schema","title":"Address.PredictionAction","data":{"type":"string","enum":["resolve","expand"],"description":"Indicates the client action when a user selects a prediction."}},"components/schemas/Address.PredictionType":{"id":"components/schemas/Address.PredictionType","kind":"json-schema","title":"Address.PredictionType","data":{"type":"string","enum":["streetAddress","postalCode","locality","premise","street"],"description":"Semantic type of the prediction result, useful for icon selection in the UI."}},"components/schemas/Address.SearchAddressesResponse":{"id":"components/schemas/Address.SearchAddressesResponse","kind":"json-schema","title":"Address.SearchAddressesResponse","data":{"type":"object","required":["predictions"],"properties":{"predictions":{"type":"array","items":{"$ref":"#/components/schemas/Address.Prediction"},"description":"List of address predictions matching the search query or container expansion."}},"description":"Response containing a list of address predictions from the autocomplete endpoint."}},"components/schemas/Address.SelectOption":{"id":"components/schemas/Address.SelectOption","kind":"json-schema","title":"Address.SelectOption","data":{"type":"object","required":["label","value"],"properties":{"label":{"type":"string","description":"The human-readable text to display.","examples":["Nordrhein-Westfalen","Stockholm","California"]},"value":{"type":"string","description":"The value to submit when this option is selected.","examples":["NW","SE-AB","CA"]}},"description":"A single option in a select/dropdown field."}},"components/schemas/Address.SiteId":{"id":"components/schemas/Address.SiteId","kind":"json-schema","title":"Address.SiteId","data":{"type":"string","minLength":1,"description":"Identifies an Ingrid site.","examples":["00000000-0000-0000-0000-000000000000"]}},"components/schemas/Address.TextDirection":{"id":"components/schemas/Address.TextDirection","kind":"json-schema","title":"Address.TextDirection","data":{"type":"string","enum":["ltr","rtl"],"description":"Text direction for form rendering."}},"components/schemas/Address.ValidateAddressRequest":{"id":"components/schemas/Address.ValidateAddressRequest","kind":"json-schema","title":"Address.ValidateAddressRequest","data":{"type":"object","required":["siteId","address"],"properties":{"siteId":{"$ref":"#/components/schemas/Address.SiteId","description":"Site identifier, referring to which site we validate the address for."},"address":{"$ref":"#/components/schemas/Address.Address","description":"The address to validate against postal reference data."}},"description":"Request to validate and standardize an address."}},"components/schemas/Address.ValidationAnalysis":{"id":"components/schemas/Address.ValidationAnalysis","kind":"json-schema","title":"Address.ValidationAnalysis","data":{"type":"object","required":["verificationLevel"],"properties":{"verificationLevel":{"$ref":"#/components/schemas/Address.VerificationLevel","description":"How granular the match was against reference data."},"changes":{"type":"array","items":{"$ref":"#/components/schemas/Address.AddressChange"},"description":"List of modifications the API made to the original address."}},"description":"Metadata about the quality and granularity of the address match."}},"components/schemas/Address.ValidationResult":{"id":"components/schemas/Address.ValidationResult","kind":"json-schema","title":"Address.ValidationResult","data":{"type":"object","required":["status","analysis"],"properties":{"status":{"$ref":"#/components/schemas/Address.ValidationStatus","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"High-level validation status for UI logic:"},"children":[]}]}]},{"$$mdtype":"Node","type":"list","attributes":{"ordered":false,"marker":"-"},"children":[{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"valid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": High confidence match. Save the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"candidate"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" automatically."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"suspect"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": Match found but with significant changes. Prompt the user \"Did you mean?\"."},"children":[]}]}]},{"$$mdtype":"Node","type":"item","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"invalid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":": No deliverable address found. Block submission."},"children":[]}]}]}]}]},"candidate":{"$ref":"#/components/schemas/Address.Address","description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The standardized, corrected address."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"Present if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"status"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" is "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"valid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" or "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"suspect"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":". Absent if "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"invalid"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"."},"children":[]}]}]}]},"analysis":{"$ref":"#/components/schemas/Address.ValidationAnalysis","description":"Metadata about the quality of the match."},"fieldReports":{"type":"object","unevaluatedProperties":{"$ref":"#/components/schemas/Address.FieldReportStatus"},"description":"Per-field validation status. Keys correspond to address field names.\nUseful for highlighting specific inputs in the UI (e.g., red border on postal code)."}},"description":"Result of address validation against postal reference data.\nContains the validation status, a standardized candidate address, match analysis,\nand per-field reports for UI highlighting.","examples":[{"status":"valid","candidate":{"countryCode":"DE","postalCode":"10117","addressLines":["Friedrichstraße 43"],"locality":"Berlin"},"analysis":{"verificationLevel":"premise"},"fieldReports":{"postalCode":"match","addressLines":"match","locality":"match"}},{"status":"suspect","candidate":{"countryCode":"SE","postalCode":"111 22","addressLines":["Sveavägen 1"],"locality":"Stockholm","administrativeArea":"Stockholms län"},"analysis":{"verificationLevel":"premise","changes":["postalCodeFixed"]},"fieldReports":{"postalCode":"fixed","locality":"match"}}]}},"components/schemas/Address.ValidationStatus":{"id":"components/schemas/Address.ValidationStatus","kind":"json-schema","title":"Address.ValidationStatus","data":{"type":"string","enum":["valid","suspect","invalid"],"description":"High-level validation status for UI logic.\nActs as a traffic light for the address validation result."}},"components/schemas/Address.VerificationLevel":{"id":"components/schemas/Address.VerificationLevel","kind":"json-schema","title":"Address.VerificationLevel","data":{"type":"string","enum":["premise","street","locality","none"],"description":"Granularity of the address match against reference data."}},"components/schemas/Common.Errors.BadRequestError":{"id":"components/schemas/Common.Errors.BadRequestError","kind":"json-schema","title":"Common.Errors.BadRequestError","data":{"type":"object","required":["status","title","type"],"properties":{"status":{"type":"number","enum":[400]},"title":{"type":"string","enum":["Bad Request"]},"type":{"type":"string","enum":["https://docs.ingrid.com/developer-resources/ingrid-api/errors/common/bad-request"]}},"allOf":[{"$ref":"#/components/schemas/Common.Errors.ProblemDetails"}],"examples":[{"status":400,"type":"https://docs.ingrid.com/developer-resources/ingrid-api/errors/common/bad-request","title":"Bad Request","instance":"urn:ingrid:request:f47ac10b-58cc-4372-a567-0e02b2c3d479"}]}},"components/schemas/Common.Errors.DetailedError":{"id":"components/schemas/Common.Errors.DetailedError","kind":"json-schema","title":"Common.Errors.DetailedError","data":{"type":"object","required":["code","detail","param"],"properties":{"code":{"type":"string","description":"A stable, machine-readable error code (and translation key).\ne.g., \"error.email.required\""},"detail":{"type":"string","description":"The final, translated, human-readable message for this specific failure."},"param":{"type":"string","format":"json-pointer","description":"The specific JSON path that caused the error.\ne.g., \"/email\""}},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"A detailed, machine-readable validation error."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This corresponds to the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"finalDetailedError"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the Go package."},"children":[]}]}]}]}},"components/schemas/Common.Errors.NotFoundError":{"id":"components/schemas/Common.Errors.NotFoundError","kind":"json-schema","title":"Common.Errors.NotFoundError","data":{"type":"object","required":["status","title","type"],"properties":{"status":{"type":"number","enum":[404]},"title":{"type":"string","enum":["Not Found"]},"type":{"type":"string","enum":["https://docs.ingrid.com/developer-resources/ingrid-api/errors/common/not-found"]}},"allOf":[{"$ref":"#/components/schemas/Common.Errors.ProblemDetails"}],"examples":[{"status":404,"type":"https://docs.ingrid.com/developer-resources/ingrid-api/errors/common/not-found","title":"Not Found","instance":"urn:ingrid:request:f47ac10b-58cc-4372-a567-0e02b2c3d479"}]}},"components/schemas/Common.Errors.ProblemDetails":{"id":"components/schemas/Common.Errors.ProblemDetails","kind":"json-schema","title":"Common.Errors.ProblemDetails","data":{"type":"object","required":["type","title","status"],"properties":{"type":{"type":"string","format":"uri","description":"A URI reference that identifies the problem type.\nThis MUST link to public documentation.\ne.g., \"https://developer-next.ingrid.com/errors/validation-error\""},"title":{"type":"string","description":"A short, human-readable summary of the problem type (translated).\ne.g., \"Validation Failed\""},"status":{"type":"integer","format":"int32","description":"The HTTP status code.\ne.g., 400"},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence (translated).\ne.g., \"One or more fields failed validation.\""},"instance":{"type":"string","format":"uri","description":"A unique identifier for the request that caused the error. Typically to be\nshared with Ingrid support for debugging.","examples":["urn:ingrid:request:f47ac10b-58cc-4372-a567-0e02b2c3d479"]},"errors":{"type":"array","items":{"$ref":"#/components/schemas/Common.Errors.DetailedError"},"description":"An array of detailed validation errors.\nThis is omitted if not applicable."}},"description":[{"$$mdtype":"Node","type":"paragraph","attributes":{},"children":[{"$$mdtype":"Node","type":"inline","attributes":{},"children":[{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"The standard, RFC 9457-compliant error response for our B2B APIs."},"children":[]},{"$$mdtype":"Node","type":"softbreak","inline":true,"attributes":{},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":"This corresponds to the "},"children":[]},{"$$mdtype":"Node","type":"code","inline":true,"attributes":{"content":"finalProblemDetails"},"children":[]},{"$$mdtype":"Node","type":"text","inline":true,"attributes":{"content":" in the Go package."},"children":[]}]}]}]}},"components/schemas/Common.Errors.ServerError":{"id":"components/schemas/Common.Errors.ServerError","kind":"json-schema","title":"Common.Errors.ServerError","data":{"type":"object","required":["status","title","type"],"properties":{"status":{"type":"number","enum":[500]},"title":{"type":"string","enum":["Internal Server Error"]},"type":{"type":"string","enum":["https://docs.ingrid.com/developer-resources/ingrid-api/errors/common/internal-server-error"]}},"allOf":[{"$ref":"#/components/schemas/Common.Errors.ProblemDetails"}],"examples":[{"status":500,"type":"https://docs.ingrid.com/developer-resources/ingrid-api/errors/common/internal-server-error","title":"Internal Server Error","instance":"urn:ingrid:request:f47ac10b-58cc-4372-a567-0e02b2c3d479"}]}},"schema_55":{"kind":"json-schema","data":{"$ref":"#/components/schemas/Address.CountryCode"},"id":"schema_55"},"schema_56":{"kind":"json-schema","data":{"$ref":"#/components/schemas/Address.SiteId"},"id":"schema_56"},"schema_57":{"kind":"json-schema","data":{"type":"string"},"id":"schema_57"},"schema_58":{"kind":"json-schema","data":{"$ref":"#/components/schemas/Address.FormType"},"id":"schema_58"},"schema_59":{"kind":"json-schema","data":{"type":"object","properties":{"Vary":{"type":"string","enum":["Accept-Language"]}},"required":["Vary"]},"id":"schema_59"},"schema_60":{"kind":"json-schema","data":{"$ref":"#/components/schemas/Address.AutocompleteFocus"},"id":"schema_60"}},"exampleStore":{"paths/~1v1~1address~1form/get/responses/200/content/application~1json/examples/Norwegian address form with postal code lookup":{"value":{"meta":{"countryCode":"NO","direction":"ltr","language":"nb-NO"},"values":{"locality":"Oslo"},"fields":{"recipientName":{"label":"Navn","required":true,"uiType":"text","keyboard":"default","autocomplete":"name"},"addressLines_0":{"label":"Gateadresse","required":true,"uiType":"text","keyboard":"default","autocomplete":"street-address","hint":"Gatenavn og nummer"},"addressLines_1":{"label":"c/o","required":false,"uiType":"text","prefix":"c/o "},"postalCode":{"label":"Postnummer","required":true,"uiType":"text","keyboard":"numeric","autocomplete":"postal-code","validationRules":[{"regex":"^\\d{4}$","message":"Oppgi et gyldig postnummer (4 siffer)"}],"hint":"0154"},"locality":{"label":"Poststed","required":true,"uiType":"text","keyboard":"default","autocomplete":"address-level2"}},"layout":[["recipientName"],["addressLines_0"],["addressLines_1"],["postalCode","locality"]]},"key":"Norwegian address form with postal code lookup","summary":"Norwegian address form with postal code lookup","description":"Returns a localized Norwegian address form with pre-filled city from postal code","id":"paths/~1v1~1address~1form/get/responses/200/content/application~1json/examples/Norwegian address form with postal code lookup"},"paths/~1v1~1address~1form/get/responses/200/content/application~1json/examples/German address form with postal code lookup":{"value":{"meta":{"countryCode":"DE","direction":"ltr","language":"de-DE"},"values":{"locality":"Berlin"},"fields":{"recipientName":{"label":"Name","required":true,"uiType":"text","keyboard":"default","autocomplete":"name"},"addressLines_0":{"label":"Straße und Hausnummer","required":true,"uiType":"text","keyboard":"default","autocomplete":"street-address","hint":"Musterstraße 1"},"addressLines_1":{"label":"Adresszusatz","required":false,"uiType":"text","hint":"Hinterhaus, 3. OG"},"postalCode":{"label":"Postleitzahl","required":true,"uiType":"text","keyboard":"numeric","autocomplete":"postal-code","validationRules":[{"regex":"^\\d{5}$","message":"Bitte geben Sie eine gültige Postleitzahl ein (5 Ziffern)"}],"hint":"10117"},"locality":{"label":"Ort","required":true,"uiType":"text","keyboard":"default","autocomplete":"address-level2"}},"layout":[["recipientName"],["addressLines_0"],["addressLines_1"],["postalCode","locality"]]},"key":"German address form with postal code lookup","summary":"German address form with postal code lookup","description":"Returns a localized German address form with pre-filled city from postal code","id":"paths/~1v1~1address~1form/get/responses/200/content/application~1json/examples/German address form with postal code lookup"},"paths/~1v1~1address~1form/get/responses/200/content/application~1json/examples/Swedish address form with postal code lookup":{"value":{"meta":{"countryCode":"SE","direction":"ltr","language":"sv-SE"},"values":{"locality":"Stockholm","administrativeArea":"Stockholms län"},"fields":{"recipientName":{"label":"Namn","required":true,"uiType":"text","keyboard":"default","autocomplete":"name"},"addressLines_0":{"label":"Adress","required":true,"uiType":"text","keyboard":"default","autocomplete":"street-address","hint":"Gatunamn och nummer"},"addressLines_1":{"label":"Care of","required":false,"uiType":"text","prefix":"c/o "},"addressLines_2":{"label":"Våning","required":false,"uiType":"text","prefix":"Våning "},"addressLines_3":{"label":"Lägenhetsnummer","required":false,"uiType":"text","prefix":"LGH "},"postalCode":{"label":"Postnummer","required":true,"uiType":"text","keyboard":"numeric","autocomplete":"postal-code","validationRules":[{"regex":"^\\d{3}\\s?\\d{2}$","message":"Ange ett giltigt postnummer (5 siffror)"}],"hint":"123 45"},"locality":{"label":"Ort","required":true,"uiType":"text","keyboard":"default","autocomplete":"address-level2"},"phoneNumber":{"label":"Telefonnummer","required":true,"uiType":"text","keyboard":"phone","autocomplete":"tel"},"email":{"label":"E-post","required":true,"uiType":"text","keyboard":"email","autocomplete":"email"}},"layout":[["recipientName"],["addressLines_0"],["addressLines_1","addressLines_2","addressLines_3"],["postalCode","locality"],["phoneNumber"],["email"]]},"key":"Swedish address form with postal code lookup","summary":"Swedish address form with postal code lookup","description":"Returns a localized Swedish address form with pre-filled city from postal code","id":"paths/~1v1~1address~1form/get/responses/200/content/application~1json/examples/Swedish address form with postal code lookup"},"paths/~1v1~1address~1search/get/responses/200/content/application~1json/examples/Text search for Dutch addresses":{"value":{"predictions":[{"id":"grp_street_nld_2201","label":"Keizersgracht","secondaryLabel":"Amsterdam, 1017","action":"expand","count":150,"type":"street"},{"id":"addr_nld_50123456","label":"Keizersgracht 585","secondaryLabel":"Amsterdam, 1017 DR","action":"resolve","type":"streetAddress"}]},"key":"Text search for Dutch addresses","summary":"Text search for Dutch addresses","description":"Returns street containers and resolvable addresses in the Netherlands","id":"paths/~1v1~1address~1search/get/responses/200/content/application~1json/examples/Text search for Dutch addresses"},"paths/~1v1~1address~1search/get/responses/200/content/application~1json/examples/Text search for German addresses":{"value":{"predictions":[{"id":"grp_street_deu_4501","label":"Friedrichstraße","secondaryLabel":"Berlin, 10117","action":"expand","count":85,"type":"street"},{"id":"addr_deu_30198765","label":"Friedrichstraße 43","secondaryLabel":"Berlin, 10117","action":"resolve","type":"streetAddress"}]},"key":"Text search for German addresses","summary":"Text search for German addresses","description":"Returns a mix of expandable street containers and resolvable addresses in Germany","id":"paths/~1v1~1address~1search/get/responses/200/content/application~1json/examples/Text search for German addresses"},"paths/~1v1~1address~1search/get/responses/200/content/application~1json/examples/Expand a street container":{"value":{"predictions":[{"id":"addr_gbr_10045832","label":"10 Buckingham Road","secondaryLabel":"Redcar, TS10 3JQ","action":"resolve","type":"streetAddress"},{"id":"addr_gbr_10045833","label":"12 Buckingham Road","secondaryLabel":"Redcar, TS10 3JQ","action":"resolve","type":"streetAddress"}]},"key":"Expand a street container","summary":"Expand a street container","description":"Drills down into a street group to show individual addresses","id":"paths/~1v1~1address~1search/get/responses/200/content/application~1json/examples/Expand a street container"},"paths/~1v1~1address~1search/get/responses/200/content/application~1json/examples/Text search for UK addresses":{"value":{"predictions":[{"id":"grp_street_882","label":"Buckingham Road","secondaryLabel":"Redcar, TS10","action":"expand","count":60,"type":"street"},{"id":"addr_gbr_20011234","label":"1 Buckingham Palace Road","secondaryLabel":"London, SW1W 0QP","action":"resolve","type":"streetAddress"}]},"key":"Text search for UK addresses","summary":"Text search for UK addresses","description":"Returns a mix of expandable street containers and resolvable addresses matching the query","id":"paths/~1v1~1address~1search/get/responses/200/content/application~1json/examples/Text search for UK addresses"},"paths/~1v1~1address~1details~1{id}/get/responses/200/content/application~1json/examples/Resolve a French address prediction":{"value":{"address":{"countryCode":"FR","postalCode":"75001","addressLines":["15 Rue de Rivoli"],"locality":"Paris"}},"key":"Resolve a French address prediction","summary":"Resolve a French address prediction","description":"Returns the full address for a resolved French prediction ID","id":"paths/~1v1~1address~1details~1{id}/get/responses/200/content/application~1json/examples/Resolve a French address prediction"},"paths/~1v1~1address~1details~1{id}/get/responses/200/content/application~1json/examples/Resolve a German address prediction":{"value":{"address":{"countryCode":"DE","postalCode":"10117","addressLines":["Friedrichstraße 43"],"locality":"Berlin"}},"key":"Resolve a German address prediction","summary":"Resolve a German address prediction","description":"Returns the full address for a resolved German prediction ID","id":"paths/~1v1~1address~1details~1{id}/get/responses/200/content/application~1json/examples/Resolve a German address prediction"},"paths/~1v1~1address~1details~1{id}/get/responses/200/content/application~1json/examples/Resolve a UK address prediction":{"value":{"address":{"countryCode":"GB","postalCode":"TS10 3JQ","addressLines":["10 Buckingham Road"],"locality":"Redcar","administrativeArea":"Redcar and Cleveland"}},"key":"Resolve a UK address prediction","summary":"Resolve a UK address prediction","description":"Returns the full address for a resolved prediction ID","id":"paths/~1v1~1address~1details~1{id}/get/responses/200/content/application~1json/examples/Resolve a UK address prediction"},"paths/~1v1~1address~1validate/post/requestBody/content/application~1json/examples/Validate an Italian address with postal code correction":{"value":{"siteId":"00000000-0000-0000-0000-000000000000","address":{"countryCode":"IT","postalCode":"00186","addressLines":["Via del Corso 1"],"locality":"Roma"}},"key":"Validate an Italian address with postal code correction","summary":"Validate an Italian address with postal code correction","description":"Submits an Italian address with a wrong postal code and missing province, receives corrected version","id":"paths/~1v1~1address~1validate/post/requestBody/content/application~1json/examples/Validate an Italian address with postal code correction"},"paths/~1v1~1address~1validate/post/requestBody/content/application~1json/examples/Validate a correct German address":{"value":{"siteId":"00000000-0000-0000-0000-000000000000","address":{"countryCode":"DE","postalCode":"10117","addressLines":["Friedrichstraße 43"],"locality":"Berlin"}},"key":"Validate a correct German address","summary":"Validate a correct German address","description":"Submits a correctly formatted address that passes validation with no changes needed","id":"paths/~1v1~1address~1validate/post/requestBody/content/application~1json/examples/Validate a correct German address"},"paths/~1v1~1address~1validate/post/requestBody/content/application~1json/examples/Validate a Swedish address with corrections":{"value":{"siteId":"00000000-0000-0000-0000-000000000000","address":{"countryCode":"SE","postalCode":"11122","addressLines":["Sveavegen 1"],"locality":"Stokholm"}},"key":"Validate a Swedish address with corrections","summary":"Validate a Swedish address with corrections","description":"Submits a misspelled address and receives back the corrected, standardized version with field-level reports","id":"paths/~1v1~1address~1validate/post/requestBody/content/application~1json/examples/Validate a Swedish address with corrections"},"paths/~1v1~1address~1validate/post/responses/200/content/application~1json/examples/Validate an Italian address with postal code correction":{"value":{"status":"suspect","candidate":{"countryCode":"IT","postalCode":"00187","addressLines":["Via del Corso 1"],"locality":"Roma","administrativeArea":"RM"},"analysis":{"verificationLevel":"premise","changes":["postalCodeFixed","componentsAdded"]},"fieldReports":{"postalCode":"fixed","addressLines":"match","locality":"match","administrativeArea":"match"}},"key":"Validate an Italian address with postal code correction","summary":"Validate an Italian address with postal code correction","description":"Submits an Italian address with a wrong postal code and missing province, receives corrected version","id":"paths/~1v1~1address~1validate/post/responses/200/content/application~1json/examples/Validate an Italian address with postal code correction"},"paths/~1v1~1address~1validate/post/responses/200/content/application~1json/examples/Validate a correct German address":{"value":{"status":"valid","candidate":{"countryCode":"DE","postalCode":"10117","addressLines":["Friedrichstraße 43"],"locality":"Berlin"},"analysis":{"verificationLevel":"premise"},"fieldReports":{"postalCode":"match","addressLines":"match","locality":"match"}},"key":"Validate a correct German address","summary":"Validate a correct German address","description":"Submits a correctly formatted address that passes validation with no changes needed","id":"paths/~1v1~1address~1validate/post/responses/200/content/application~1json/examples/Validate a correct German address"},"paths/~1v1~1address~1validate/post/responses/200/content/application~1json/examples/Validate a Swedish address with corrections":{"value":{"status":"suspect","candidate":{"countryCode":"SE","postalCode":"111 22","addressLines":["Sveavägen 1"],"locality":"Stockholm","administrativeArea":"Stockholms län"},"analysis":{"verificationLevel":"premise","changes":["postalCodeFixed","spellingCorrected","componentsAdded"]},"fieldReports":{"postalCode":"fixed","addressLines":"fixed","locality":"fixed","administrativeArea":"match"}},"key":"Validate a Swedish address with corrections","summary":"Validate a Swedish address with corrections","description":"Submits a misspelled address and receives back the corrected, standardized version with field-level reports","id":"paths/~1v1~1address~1validate/post/responses/200/content/application~1json/examples/Validate a Swedish address with corrections"}},"securitySchemeStore":{"BearerAuth":{"id":"BearerAuth","type":"http","scheme":"Bearer"}},"servers":[{"url":"/_mock/developer-resources/ingrid-api/openapi","isMockServer":true,"description":"Mock server"},{"url":"https://api.ingrid.com","description":"Production"}],"specType":"openapi"},"options":{"feedback":{"hide":true,"settings":{"label":""}},"mockServer":{"url":"/_mock/developer-resources/ingrid-api/openapi","position":"first","description":"Mock server"},"disableRouter":true,"downloadUrls":[{"url":"/_bundle/developer-resources/ingrid-api/@v1/openapi.json?download"},{"url":"/_bundle/developer-resources/ingrid-api/@v1/openapi.yaml?download"}],"excludeFromSearch":false,"replayFeatures":{"graphql":false},"specType":"openapi","markdocOptions":{"tags":{},"nodes":{},"components":{}},"metadata":{"title":"Ingrid API","description":"The Ingrid API is organized around REST. Our API has predictable resource-oriented URLs, accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and verbs. You can use the Ingrid API in test mode, which doesn't affect your live data or interact with carrier networks. The API key you use to authenticate the request determines whether the request is live mode or test mode."}},"baseSlug":"/developer-resources/ingrid-api/openapi","routesMapping":{}}