---
title: "List Partoo categories"
method: GET
path: "/categories"
tags: ["Categories"]
---

# List Partoo categories

`GET /categories`

This endpoint lets you read and filter through Partoo categories.

## Query parameters

- `country` string
- `lang` 'fr' | 'en' | 'es' | 'it' | 'pt-br' | 'de' | 'ar' | 'nl' | 'pl' | 'cs' | 'ca' | 'sk' | 'pt' | 'lv' | 'ro' | 'bg' | 'hu' — Available language in the application
- `state` 'OK' | 'DEPRECATED'
- `block_push_long_description_on_gmb` boolean
- `search_query` string
- `order_by` 'gmb_id' | '-gmb_id' | 'impacted_businesses' | '-impacted_businesses'
- `live__isnull` boolean
- `page` integer
- `per_page` integer
- `with_names` boolean
- `with_countries` boolean

## Response `200`

OK

- object
  - `page` integer — Current page number
  - `max_page` integer — Last page number
  - `count` integer — Number of resources complying with filters
  - `categories` CategorySql[] — List of categories
    - `id` integer — Category id
    - `gmb_id` string — Unique category id. This is the id you should pass in business.categories array when creating/updating a business
    - `name` string — Category name in given language or user's language
    - `names` CategorySqlName[] — Category names translated for available languages *If `with_names` is true*
      - `name` string — Translated category name
      - `lang` string — Available language in the application
    - `state` string — State of category ( OK or DEPRECATED )
    - `block_push_long_description_on_gmb` boolean — Boolean indicating if the business long description can be pushed to Google when the business belongs to this category
    - `countries` string[] — Array of strings representing the list of country codes in which the category is available *If `with_countries` is true*
    - `live_id` string, nullable — Live category id to which the category is mapped (deprecated categories are mapped to the closest category)

## Other responses

- `400` — Your request is incorrect
- `401` — You are not authenticated

---

[API](https://skmtc.net/partoo/apis/partoo-rest-api.md) · [All operations](https://skmtc.net/partoo/apis/partoo-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/partoo/partoo-rest-api/revisions/3652d8b1a8b3/schema)