Acuris

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

Actions4

Geocode Address

AI-generated

Summary

Geocodes a postal address to latitude/longitude by sending a GET request to the Acuris /geocode endpoint, once per input item. UK (gbr) requests go to the paf.acuris-geo.com host; all other countries use api.acuris-geo.com.

Inputs

  • country (required) — ISO 3-letter country code (default 'gbr'). Lowercased before sending. Also selects the API host: 'gbr' uses the UK PAF host, everything else the default host.
  • street — Street name. Sent as the 'street' query parameter (empty string if blank).
  • houseNumber — House number. Sent as 'house_number'.
  • city — City or town. Sent as 'city'.
  • postcode — Postal code. Sent as 'postcode'.
  • state — 2–3 letter region code, relevant for USA, CAN, AUS, BRA, MEX. Sent as 'state'.

Output shape

One output item per input item, whose json is the raw response body from the Acuris /geocode API (expected to contain coordinates, but the exact fields are not defined in the node). Each item is paired to its input item.

Requires the acurisApi credential. Only the structured address fields are used; there is no single-line input for geocoding. Blank fields are still sent as empty strings, and the node does not validate that any address field is filled. If 'Continue On Fail' is enabled, a failing item returns { error: message } instead of stopping the workflow.

Examples

Example 1: Geocode a UK address from a CRM record

Country: gbr; House Number: 10; Street: Downing Street; City: London; Postcode: SW1A 2AA

Example 2: Geocode a US address using expressions from incoming data

Country: usa; Street/House Number/City mapped from {{$json}} fields; State: CA; Postcode: 94043

Links

Discussion