# Retornar as categorias por filtro

Permite listar categorias de produtos cadastradas na Conta Azul, com paginação e filtro por texto. Útil para validar categoria na criação de produtos.

Endpoint: GET /v1/produtos/categorias
Version: v1
Security: BearerAuth

## Query parameters:

  - `pagina` (integer)
    Página

  - `tamanho_pagina` (integer)
    Tamanho da página
    Enum: 10, 20, 50, 100, 200, 500, 1000

  - `busca_textual` (string)
    Busca textual pela descrição da categoria

## Response 200 fields (application/json):

  - `items` (array)
    lista de categorias de produtos

  - `items.descricao` (string)
    Descrição da categoria
    Example: "Eletrônicos"

  - `items.id` (integer)
    id da categoria
    Example: 1

  - `items.uuid` (string)
    uuid da categoria
    Example: "550e8400-e29b-41d4-a716-446655440000"

  - `total_items` (integer)
    total de itens
    Example: 10

## Response 400 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: "Mensagem de erro detalhada"

## Response 500 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: "Mensagem de erro detalhada"