Acuris

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

Actions4

Lookup UK Postcode

AI-generated

Summary

Looks up a UK postcode via the Acuris Royal Mail PAF service and returns every address at that postcode. Runs once per input item and emits the API's JSON response as the item output.

Inputs

  • UK Postcode (required) — The UK postcode to look up (e.g. SW1A 2AA). Whitespace is trimmed; an empty value throws a 'postcode is required' error for that item.

Output shape

One output item per input item, whose json is the raw response from the Acuris postcode-lookup endpoint (the list of addresses at the postcode).

The country is fixed to 'gbr' and the request is a POST to https://paf.acuris-geo.com/postcode-lookup with body {postcode, country}, authenticated with the acurisApi credential. The exact response fields are not defined in the node source. With Continue On Fail enabled, failed items return {error: message} instead of stopping the workflow. Each output item is paired to its input item.

Examples

Example 1: Populate an address dropdown or form from a customer-entered postcode.

Operation: Lookup UK Postcode; UK Postcode set to the expression {{ $json.postcode }}.

Example 2: Check a single fixed postcode.

Operation: Lookup UK Postcode; UK Postcode: SW1A 2AA.

Links

Discussion