---
title: "Validate a customer-selected service destination"
method: POST
path: "/v1/account/destination-location-proofs"
---

# Validate a customer-selected service destination

`POST /v1/account/destination-location-proofs`

## Request

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

First-party customer/mobile route. Accepts one real US service address in the POST body, validates it server-side with Google Address Validation, and returns only an opaque short-lived destination proof. It never returns the submitted or normalized address, coordinates, or exact accuracy. Google Maps attribution must remain visible in the first-party destination UI.

## Request body

- DestinationLocationProofRequest
  - `address` string, required: A real US service address. It is accepted only in this POST body and is never returned, placed in a URL, or exposed to an external agent.
  - `premise_proximity_confirmation_token` string: Opaque one-time token from the immediately preceding premise-proximity challenge for the same address and authority.

## Response `201`

Private destination proof created.

- DestinationLocationProofResponse
  - `location_proof_id` string, uuid, required
  - `status` 'ready', required
  - `location_kind` 'destination', required
  - `display_label` 'Selected service address', required
  - `usable_until` string, date-time, required
  - `uses_remaining` integer, required
  - `address_returned` unknown, required
  - `coordinates_returned` unknown, required

## Other responses

- `400`: The address is invalid, unsupported, incomplete, ambiguous, or cannot safely mint premise-level authority.
- `401`: A valid signed-in customer session is required.
- `403`: The session is not an active customer account.
- `409`: Premise-proximity confirmation is required, or its opaque confirmation token is invalid, expired, replayed, or bound to another authority/address/provider anchor.
- `429`: Too many destination-proof requests.
- `503`: Server-side address validation or destination authority storage is unavailable.

---

[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)