> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telzino.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Places

> Search Google business listings to find a Place ID for an agent

## Query Parameters

<ParamField query="q" type="string" required>
  Business name or address to search for. Queries shorter than 3 characters return an empty list; the maximum length is 256 characters.
</ParamField>

Returns place suggestions. Use the `placeId` from a result as the `googlePlaceId` on [Create](/api-reference/agents/create) or [Update Agent](/api-reference/agents/update).

## Feature Administration gating

When [Feature Administration](/admin-guide/dashboard/feature-administration) is enabled and **Business Listing (Google Places)** is locked for your account, this endpoint returns `403 forbidden` instead of performing the search.

This endpoint is authenticated per account and carries no organization, so it reflects an **account-level** lock only. A lock placed on an individual reseller or organization is enforced where a Place ID is actually saved — on [Create](/api-reference/agents/create) and [Update Agent](/api-reference/agents/update).

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.telzino.com/v1/places/search?q=Acme%20Coffee%20Chicago" \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      { "placeId": "ChIJN1t_tDeuEmsRUsoyG83frY4", "text": "Acme Coffee — 123 Main St, Chicago, IL" }
    ]
  }
  ```

  ```json 400 theme={null}
  { "error": "Missing query parameter q" }
  ```

  ```json 403 theme={null}
  {
    "error": "forbidden",
    "error_description": "Google Places is not available for this account"
  }
  ```
</ResponseExample>