---
title: "Suggest service addresses for a signed-in customer"
method: POST
path: "/v1/account/destination-address-suggestions"
---

# Suggest service addresses for a signed-in customer

`POST /v1/account/destination-address-suggestions`

## Request

- Base URL: `https://loppee.com`
- URL: `https://loppee.com/v1/account/destination-address-suggestions`
- Auth: HTTP bearer

First-party customer/mobile and authenticated handoff UI route; not an external-agent 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.
- `401`: A valid signed-in customer session is required.
- `403`: The session is not an active customer account or an API/agent key was supplied.
- `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)