---
title: "Suggest service addresses in the first-party browser UI"
method: POST
path: "/v1/destination-address-suggestions"
---

# Suggest service addresses in the first-party browser UI

`POST /v1/destination-address-suggestions`

## Request

- Base URL: `https://loppee.com`
- URL: `https://loppee.com/v1/destination-address-suggestions`
- Auth: none required

Same-origin first-party browser UI route; not an external-agent or native-app API. After four normalized characters, it forwards only the partial input through Loppee to Google Places Autocomplete (New) and returns at most five display-text-only suggestions. Loppee does not retain the partial input or suggestion list. Provider ids, coordinates, address metadata, and autocomplete session tokens are never returned. The UI must keep manual entry available and show Google Maps attribution with the suggestions.

## Request body

- DestinationAddressSuggestionsRequest
  - `input` string, required: Normalized partial US service-address text. This first-party display request contains no session token, place id, coordinates, or proof authority.

## Response `200`

Display-only address suggestions.

- DestinationAddressSuggestionsResponse
  - `suggestions` DestinationAddressSuggestion[], required
    - `full_text` string, required
    - `main_text` string, required
    - `secondary_text` string, required

## Other responses

- `400`: The partial input is shorter than four normalized characters, too long, or malformed.
- `403`: The request is not an allowed same-origin browser flow.
- `404`: Destination address suggestions are disabled on this deployment.
- `429`: Too many address-suggestion requests.
- `503`: Google Places Autocomplete (New) is unavailable or returned an invalid response.

---

[API](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents.md) · [All operations](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/llms.txt) · [OpenAPI document](https://skmtc.dev/loppee/apis/loppee-business-registry-api-for-external-agents/revisions/37285f7cddcd?raw)