# Get GBP Categories

```http
GET https://api.synup.com/api/v4/gbp-categories
```

This API retrieves the Google Business Profile (GBP) categories available in a country. Use the `siteCategoryId` (GCID) of a category as `primaryGbpSiteCategoryId` or in `additionalGbpSiteCategoryIds` when you create or update a location in that country.

`countryIso` is required. Pass `siteCategoryId` as well to look up a single category, e.g. to check that a GCID is valid in that country before using it.

Source: https://developer.synup.com/api/locations/get-gbp-categories

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `countryIso` | string | required | Required. ISO 3166-1 alpha-2 code of the country (case-insensitive), e.g. `US`. Returns the categories available for locations in this country. |
| `siteCategoryId` | string | optional | Optional. A Google category ID (GCID), e.g. `gcid:bakery`. Returns only this category. Returns an error if it is not a GBP category in the given country. |

## Example request

```bash
curl -X GET 'https://api.synup.com/api/v4/gbp-categories' \
  -H 'Authorization: API YOUR_API_KEY' \
  -H 'Content-Type: application/json'
```

## Responses

| Status | Description |
| --- | --- |
| `200` | Successfully retrieved GBP categories. |
| `400` | Bad request. gbpCategories is null and errors[0].message says why: "countryIso is required." when countryIso is missing; "This country doesn't exist." when countryIso is not a known country; or "'gcid:not_a_category' is not a Google Business Profile category in US." when siteCategoryId is not a GBP category in that country. |
| `401` | Unauthorized. Invalid or missing API key (errors[0].message is "SY90005:Invalid Token"). |
| `500` | Internal Server Error. |
