---
title: "List GBP locations"
method: GET
path: "/v1/connect/googlebusiness/locations"
tags: ["Connect"]
---

# List GBP locations

`GET /v1/connect/googlebusiness/locations`

For headless flows. Returns the list of GBP locations the user can manage. Use pendingDataToken (from the OAuth callback redirect) to list locations without consuming the token, so it remains available for select-location. Use X-Connect-Token header if connecting via API key.

## Query parameters

- `profileId` string
- `pendingDataToken` string
- `tempToken` string
- `search` string
- `filter` string

## Response `200`

List of Google Business locations available for connection

- object
  - `locations` object[]
    - `id` string — Location ID
    - `name` string — Business name
    - `accountId` string — Google Business Account ID
    - `accountName` string — Account name
    - `address` string — Business address
    - `category` string — Business category
    - `storeCode` string — Store code set on the location in Google Business Profile (if any)
  - `hasMore` boolean — True when more locations exist than were returned (the list is bounded). Prompt the user to narrow the result set with search.

## Other responses

- `400` — Missing required parameters (profileId or tempToken)
- `401` — Unauthorized
- `500` — Failed to fetch locations (e.g., invalid token, insufficient permissions)

---

[API](https://skmtc.net/zernio/apis/zernio-api.md) · [All operations](https://skmtc.net/zernio/apis/zernio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/zernio/zernio-api/versions/f81ca70ea6b9/schema)