Migrating from Loqate

Stable

Switch from Loqate Capture Interactive to SnapAddress. Same two-step Find/Retrieve flow — just change the base URL.

Overview

SnapAddress provides Loqate Capture Interactive compatible endpoints. The same two-step Find and Retrieve flow works with identical request parameters and response shapes.

Step 2: Change your base URL

Replace the Loqate/Addressy base URL with SnapAddress:

- https://api.addressy.com
+ https://api.snapaddress.io

Authentication works the same way — pass your key as the Key query parameter.

Step 3: Verify

Your existing integration should work immediately. The compatible endpoints are:

Find (search)

GET /Capture/Interactive/Find/v1.1/json3.ws?Key=KEY&Text=query&Countries=GB

Returns a list of matching postcodes and addresses. For a postcode match, Id is the postcode itself:

{
  "Items": [
    {
      "Id": "SW1A 2AA",
      "Type": "Postcode",
      "Text": "SW1A 2AA",
      "Highlight": "",
      "Description": "Downing Street - 3 Addresses"
    }
  ]
}

When a result has Type: "Postcode", pass its Id (the postcode) as Container to drill down into the individual addresses:

GET /Capture/Interactive/Find/v1.1/json3.ws?Key=KEY&Text=SW1A 2AA&Countries=GB&Container=SW1A 2AA

The drill-down returns Type: "Address" items, each with an Id you pass to Retrieve.

Retrieve (get full address)

GET /Capture/Interactive/Retrieve/v1.1/json3.ws?Key=KEY&Id=23747771

Returns the full structured address (the Id comes from an Address-type Find result):

{
  "Items": [
    {
      "Id": "23747771",
      "DomesticId": "23747771",
      "Line1": "10 Downing Street",
      "Line2": "",
      "Line3": "",
      "Line4": "",
      "Line5": "",
      "City": "LONDON",
      "PostalCode": "SW1A 2AA",
      "CountryName": "United Kingdom",
      "CountryIso2": "GB",
      "Company": "Prime Minister & First Lord Of The Treasury",
      "BuildingNumber": "10",
      "BuildingName": "",
      "SubBuilding": "",
      "Department": ""
    }
  ]
}

Id, DomesticId, and the address's UDPRN are all the same value — store any of them as a stable reference.

Differences to be aware of

UK only: SnapAddress is a UK-specific API. Set Countries=GB on all Find requests (other country codes are not supported).
Unsupported Loqate features: Validate, Typeahead, and international endpoints are not available.
Out of credits: when your balance is exhausted, Find and Retrieve return 402 (matching Loqate). Top up from the pricing page.
Transparent pricing: one-off credit packs, not per-click contracts or bundled minimums. Credits are valid for 12 months. See the pricing page for current rates.
Data source: SnapAddress uses Royal Mail PAF data, updated monthly.

Once migrated, consider switching to the native SnapAddress API for a simpler integration with fewer round trips. The native autocomplete endpoint returns postcode suggestions in a single call, and postcode lookup returns all addresses at once.