---
title: "List Google Business Profile categories"
method: GET
path: "/v1/accounts/{accountId}/gmb-categories"
tags: ["Connect"]
---

# List Google Business Profile categories

`GET /v1/accounts/{accountId}/gmb-categories`

## Request

- Base URL: `https://zernio.com/api`
- URL: `https://zernio.com/api/v1/accounts/{accountId}/gmb-categories`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/zernio/apis/zernio-api/docs/v1/accounts/:accountId/gmb-categories/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists the business categories Google accepts for a region, localized to `languageCode`.
Use the returned `name` (e.g. `categories/gcid:afghani_restaurant`) as the primary category when creating or updating a location.

Not location-scoped: works for a Google Business Profile account that has no location yet.

`query` matches only the START of the display name in `languageCode` (`Restaurante` returns `Restaurante afgano`, but `afgano` returns nothing). Results are paginated with `nextPageToken`, 100 per page.

## Path parameters

- `accountId` string, required

## Query parameters

- `regionCode` string, required
- `languageCode` string, required
- `query` string
- `pageToken` string

## Response `200`

Categories fetched successfully

- object
  - `success` boolean
  - `accountId` string
  - `categories` object[]
    - `name` string: Category resource name, e.g. "categories/gcid:afghani_restaurant".
    - `displayName` string: Category name localized to languageCode.
  - `nextPageToken` string: Present when more categories are available.

## Other responses

- `400`: Invalid request (missing regionCode or languageCode, wrong platform, or Google rejected a field)
- `401`: Missing or invalid API key. `code` is `missing_credentials` when no Authorization header was sent and `invalid_credentials` when the key is unknown, revoked or expired.
- `404`: Resource not found

## Changes

- **2026-11-12** `081e9a361b7a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/accounts/:accountId/gmb-categories/get.md)

---

[API](https://skmtc.dev/zernio/apis/zernio-api.md) - [All operations](https://skmtc.dev/zernio/apis/zernio-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zernio/apis/zernio-api/revisions/fb5bf0786e06?raw)
