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

# getMerchantCategories

> Get the merchant categories.

Get the merchant categories (e.g. Dining, Travel), ordered by display priority. Use a category's id with `getMerchants(categoryId:)` to list its merchants. Requires LIST\_OFFERS scope.

```graphql theme={null}
query {
  getMerchantCategories: [MerchantCategory!]!
}
```

## Returns

[`[MerchantCategory!]!`](/api-reference/types/merchant-category) — MerchantCategory is a curated shopping category (e.g. Dining, Travel) that groups merchants.

## Example

```graphql theme={null}
query GetMerchantCategories {
  getMerchantCategories {
    categoryId
    name
  }
}
```

```json theme={null}
{
  "data": {
    "getMerchantCategories": [
      { "categoryId": "223e4567-e89b-12d3-a456-426614174001", "name": "Dining" },
      { "categoryId": "323e4567-e89b-12d3-a456-426614174002", "name": "Travel" }
    ]
  }
}
```

The list is the same taxonomy shown in the Fluz catalog, ordered by display priority. Category ids are stable, so store the id rather than the name if you cache the mapping — a category can be renamed.