Acuris

Address validation, postcode lookup, geocoding & reverse geocoding (240+ countries, Royal Mail PAF for UK).

Actions4

Validate Address

AI-generated

Summary

Validates a postal address against Acuris reference data by POSTing it to the Acuris /validate endpoint, accepting either a single-line string or fielded components, and returns the API's JSON response per input item.

Inputs

  • country (required) — ISO 3-letter country code (default 'gbr'). Lowercased before sending. 'gbr' routes to the UK PAF host (paf.acuris-geo.com); all other countries use api.acuris-geo.com.
  • inputString — Whole address as one string. If non-blank (after trimming), it is sent as the input and all fielded inputs are ignored.
  • street — Street name; used only when Single-line Input is blank.
  • houseNumber — House number; sent as house_number when using fielded input.
  • city — City or locality for fielded input.
  • postcode — Postcode for fielded input.
  • state — 2-3 letter region code, relevant for USA, CAN, AUS, BRA, MEX.

Output shape

One output item per input item, whose json is the raw response from the Acuris /validate endpoint.

Each output is paired to its input item. Requires acurisApi credentials. If 'Continue On Fail' is enabled, failed items return { error: message } instead of stopping the workflow. The response schema is defined by the API and not specified in the node.

Examples

Example 1: Validate a UK address pasted as one line from a form field

Country: gbr; Single-line Input: {{ $json.address }}

Example 2: Validate a structured US address from a CRM record

Country: usa; House Number, Street, City, Postcode from item fields; State: CA

Links

Discussion