Skip to main content
GET
/
Capture
/
Interactive
/
Find
/
v1.20
/
json6.ws
Capture_Interactive_Find
curl --request GET \
  --url 'https://api.addressy.com/Capture/Interactive/Find/v1.20/json6.ws?Key='
{
  "Items": [
    {
      "Id": "GB|RM|A|52509479",
      "Type": "Address",
      "Text": "High Street",
      "Highlight": "0-2,6-4;0-3",
      "Description": "London"
    }
  ]
}
Note this does not return formatted addresses, and repeated calls to this service may be required to drill-down through results until an address ID is returned. The address ID should then be passed into the Retrieve service to obtain a fully formatted address. This method does not consume credit.
We don’t support API connections using HTTP - all calls should use HTTPS.

Authorizations

​
Key
string
query
required

Query Parameters

​
Key
string
required

The key used to authenticate with the service.

​
Text
string
required

The search text to find. Ideally a postcode or the start of the address.

​
IsMiddleware
boolean

Whether the API is being called from a middleware implementation (and therefore the calling IP address should not be used for biasing).

​
Container
string

A container for the search. This should only be another Id previously returned from this service when the Type of the result was not 'Address'.

​
Origin
string

A starting location for the search. This can be the name or ISO 2 or 3 character code of a country, WGS84 coordinates (comma separated) or IP address to search from.

​
Countries
string

A comma separated list of ISO 2 or 3 character country codes to limit the search within.

​
Limit
integer

The maximum number of results to return.

​
Language
string

The preferred language for results where the same address matches input in different languages. This parameter will also affect the label "Addresses" in the Description field of the Container results, eg. where Language=es, the value will be "direcciones". The value should be a 2 or 4 character language code e.g. (en, fr, en-gb, en-us).

​
Bias
boolean

Enable/Disable biasing

​
Filters
string

This setting allows filtering of addresses returned by the Find method in the latest Capture. Supported filters are described below.

​
GeoFence
string

This setting is currently under review and should not be used.

​
Type
string

This setting interprets the text query parameter differently. Can only be used in conjunction with the AddressBase premium dataset.

Response

Success

​
Items
object[]