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

# GET /api/v1/categories: Listar Categorias da Loja

> Lista todas as categorias da loja autenticada com id, nome, descrição e campo order que controla a ordem de exibição no catálogo de produtos.

Use este endpoint para recuperar todas as categorias cadastradas na sua loja. As categorias permitem organizar seu catálogo de produtos, e cada uma retorna um identificador único, nome, descrição e um campo de ordenação que controla como elas aparecem para o cliente final.

## Método

`GET /api/v1/categories` — Requer autenticação.

## Exemplo de Requisição

```bash theme={null}
curl -X GET 'https://api.bukiopay.com/api/v1/categories' \
  --header 'Authorization: Bearer sk_live_sua_api_key'
```

## Resposta

```json theme={null}
{
  "categories": [
    {
      "id": "cat_123",
      "name": "Categoria Exemplo",
      "description": "Descrição da categoria",
      "order": 1,
      "createdAt": "2026-01-01T00:00:00.000Z"
    }
  ]
}
```

## Campos da Resposta

<ResponseField name="categories" type="array">
  Lista de categorias da loja autenticada.

  <Expandable title="Propriedades de cada categoria">
    <ResponseField name="id" type="string">
      Identificador único da categoria.
    </ResponseField>

    <ResponseField name="name" type="string">
      Nome da categoria exibido no catálogo.
    </ResponseField>

    <ResponseField name="description" type="string">
      Descrição opcional da categoria.
    </ResponseField>

    <ResponseField name="order" type="number">
      Ordem de exibição da categoria. Categorias com valores menores aparecem primeiro na listagem.
    </ResponseField>

    <ResponseField name="createdAt" type="string">
      Data e hora de criação da categoria no formato ISO 8601.
    </ResponseField>
  </Expandable>
</ResponseField>

<Note>
  O campo `order` controla a ordem de exibição das categorias no seu catálogo. Categorias com valor `order` menor são exibidas antes das demais. Use os endpoints de criação e atualização para definir esta ordenação conforme sua necessidade.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.