Find/Lookup addresses

POST

/user/addresses/lookup/find

Search for address suggestions using Loqate's /Find endpoint. This endpoint returns a list of either addresses or "containers" — groupings like cities, streets, or postcodes.

You can refine the search by using the container field in your request to drill down into a specific result.

To retrieve the full details of a selected address, use the GET /user/addresses/find endpoint with the address ID.

Note: In development mode, we only get 50 requests per day!

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/json

Examples

Responses

🟢200OK

application/json

Find a list of addresses, or containers to refine the user's search

Body

Request Example

Shell

JavaScript

Java

Swift

cURL

Search by "text"Refine search by "container"

curl --location --request POST 'https://api.managem.co.uk/user/addresses/lookup/find' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "text": "34 Selborne Cl"
}'

Response Example

Search by text

[
    {
        "id": "GB|RM|A|10321882|ENG",
        "description": "Petersfield GU32 2JB",
        "type": "Address",
        "text": "34 Selborne Close",
        "highlight": "0-2,3-11,12-14"
    }
]

Finalize message attachment

Retrieve full address details