Developers
API referenceBusiness sign in

Checkout

Address suggestions

GET/checkout/places

Browser · publishable key

Browser only, called by the widget. Address suggestions from Google Maps Places when Qoene has it configured; available: false means the widget shows a plain address field.

Request

Query parameters

Query parameters
NameInTypeDescription
inputOptionalquerystringWhat the buyer typed (required).At most 200 characters

Response

Success responses
StatusMeaning
200Suggestions

The body is { "status": "success", "data": … }. Fields of data (CheckoutPlaces):

Response data
FieldTypeDescription
availableRequiredboolean
suggestionsRequiredarray of object
placeIdRequiredstring
textRequiredstring

Errors

Errors use the error envelope { "status": "error", "message", "code"?, "details"? }.

Error responses
StatusWhen
400The request is not valid. A field is missing or invalid, or the Idempotency-Key header is missing or malformed.
401Missing, invalid, expired or revoked API key. The API key is missing, invalid, expired or revoked.
403The key lacks the scope, or the operation needs a LIVE key. The key lacks the scope, or this call needs a LIVE key (LIVE_KEY_REQUIRED), or the Business owner is not verified (SENDER_VERIFICATION_REQUIRED).
429Too many requests. See the RateLimit headers. Too many requests. Wait for Retry-After, then retry with the same idempotency key.