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

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

Addresses

Find addresses

Search for address suggestions from a free-text query.

Use this endpoint as step 1 in an assisted address-entry flow.

Request guidance:

Provide a user-entered text value such as postcode, street name, or partial address.
Provide container when refining from a previous response.
Include a valid bearer token; this is an authenticated user endpoint.

Recommended flow:

Call POST /user/addresses/lookup/find with text from the user input.
If container-type results are returned, call this endpoint again with container to drill down.
When an address result is selected, call POST /user/addresses/lookup/retrieve with its id.
Persist the final address with POST /user/addresses.

Behavior notes:

Returns suggestions only; no address is saved to the account.
Responses may include both final addresses and intermediate container nodes.
Empty results are valid and should be handled in UI as “no matching addresses found”.

POST

user

addresses

lookup

find

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

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

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

text

string

required

The search term provided by the user

Example:

"55 Walnut tr"

container

string

The ID of a container to refine the search

Example:

"GB|RM|A|10321882|ENG"

limit

number

default:10

The maximum number of results to return

Required range: 1 <= x <= 20

Response

200 - application/json

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

string

required

The ID of the location, use this to retrieve the full address

description

string

required

A description of the location or "container"

type

required

The type of location, e.g. "Address", "Postcode", etc.

Available options:

Container

text

string

required

The text matching the provided search

highlight

string

required

A comma-separated list of highlighted indices in the text, ie. 0-2,3-9

Finalize cover upload Retrieve address details