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

# Get Category

> Busca uma categoria pelo slug.
<Note>Diferente da listagem, esta rota não filtra por visibilidade: uma categoria oculta continua acessível pela URL direta. É intencional, e é o que permite categorias que existem mas não aparecem no menu.</Note>



## OpenAPI

````yaml /openapi/storefront-catalog.yaml get /webstore/category/{slug}
openapi: 3.1.0
info:
  title: CentralCart Storefront API (Catálogo)
  version: 1.0.0
  description: >-
    Produtos, categorias e posts do blog da loja. Nenhum destes endpoints exige
    autenticação. A loja é resolvida pelo header `x-store-domain`.
servers:
  - url: https://api.centralcart.io/v1
    description: Produção
security: []
paths:
  /webstore/category/{slug}:
    get:
      tags:
        - Catalogo
      summary: Get Category
      description: >-
        Busca uma categoria pelo slug.

        <Note>Diferente da listagem, esta rota não filtra por visibilidade: uma
        categoria oculta continua acessível pela URL direta. É intencional, e é
        o que permite categorias que existem mas não aparecem no menu.</Note>
      operationId: getWebstoreCategory
      parameters:
        - $ref: '#/components/parameters/StoreDomain'
        - name: slug
          in: path
          required: true
          description: Slug da categoria
          schema:
            type: string
        - name: include_prices
          in: query
          required: false
          description: >-
            Quando `true`, inclui `min_price` e `max_price`. Deixa a resposta
            mais lenta, então só peça quando for exibir faixa de preço.
          schema:
            type: boolean
        - name: include_sub_categories
          in: query
          required: false
          description: >-
            Quando `true`, inclui as subcategorias em `sub_categories` (padrão:
            `true`).
          schema:
            type: boolean
      responses:
        '200':
          description: Categoria encontrada
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Category'
        '404':
          description: Categoria não encontrada
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                errors:
                  - message: Category not found.
      security: []
components:
  parameters:
    StoreDomain:
      name: x-store-domain
      in: header
      required: true
      description: 'Domínio da sua loja (ex: sualoja.centralcart.ai)'
      schema:
        type: string
  schemas:
    Category:
      type: object
      properties:
        id:
          type: number
        store_id:
          type: number
        parent_id:
          type: number
          nullable: true
        position:
          type: number
        name:
          type: string
        slug:
          type: string
        image:
          type: string
          nullable: true
        banner:
          type: string
          nullable: true
        hide_category:
          type: boolean
        hide_subcategory:
          type: boolean
        packages_count:
          type: number
          description: Quantidade de produtos disponíveis e habilitados nesta categoria.
        min_price:
          type: number
          description: >-
            Só presente com `include_prices=true`, e omitido quando a categoria
            não tem produtos.
        max_price:
          type: number
          description: >-
            Só presente com `include_prices=true`, e omitido quando a categoria
            não tem produtos.
        sub_categories:
          type: array
          description: >-
            Subcategorias visíveis, ordenadas por `position`.

            A própria categoria é incluída como **primeiro elemento** desta
            lista, para que a navegação por abas mostre "todos" antes das
            subdivisões. Filtre por `parent_id` se quiser apenas as filhas de
            verdade.
          items:
            $ref: '#/components/schemas/Category'
        created_at:
          type: string
        updated_at:
          type: string
    Error:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
              code:
                type: string
              ref:
                type: string

````