---
title: "Search for locations by text query"
method: GET
path: "/v1/utilities/locations/search"
tags: ["Location Utilities"]
---

# Search for locations by text query

`GET /v1/utilities/locations/search`

## Query parameters

- `q` string, required
- `maxResults` integer

## Response `200`

Location suggestions retrieved successfully

- LocationArrayApiResponseDto
  - `success` boolean, required — Indicates if the request was successful
  - `message` string, required — Human readable message
  - `data` object[], required — Response data
    - `locationId` string, required — AWS Location Service Place ID
    - `fullAddress` string, required — Full formatted address
    - `addressNumber` string — Street address number
    - `addressName` string — Street name
    - `city` string, required — City name
    - `state` string — State or region
    - `zipCode` string — Postal/ZIP code
    - `country` string, required — Country name
    - `coordinates` object, required — Geographic coordinates
      - `lng` number, required — Longitude
      - `lat` number, required — Latitude
  - `timestamp` string, date-time, required — Timestamp of the response

---

[API](https://skmtc.dev/maket/apis/virtual-architect-api.md) · [All operations](https://skmtc.dev/maket/apis/virtual-architect-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/maket/virtual-architect-api/revisions/7635e6f94477/schema)