---
title: "Listar categorias"
method: GET
path: "/categorias"
tags: ["Categorias"]
---

# Listar categorias

`GET /categorias`

## Request

- Base URL: `https://app.vendizap.com/api`
- URL: `https://app.vendizap.com/api/categorias`
- Auth: API key in header `X-Auth-Id` and API key in header `X-Auth-Secret`

Método utilizado para listar as categorias existentes. Os parâmetros
abaixo são opcionais — caso nenhum seja informado, serão retornadas
todas as categorias. Os parâmetros não fazem busca exata; retornam
registros que contenham o texto informado. Por exemplo, ao filtrar
a descrição "carne", serão retornadas todas as categorias que contêm
a palavra "carne" em sua descrição. O filtro de código possui o
mesmo comportamento.

### Retorno

O retorno deste método será sempre um array com os objetos das
categorias filtradas.

## Query parameters

- `nome` string
- `codigo` string

## Response `200`

Lista de categorias.

- Categoria[]
  - `id` string
  - `nome` string
  - `codigo` string, nullable
  - `imagem` string, nullable

## Other responses

- `401`: Credenciais informadas inválidas.

---

[API](https://skmtc.dev/vendizap/apis/api-vendizap.md) · [All operations](https://skmtc.dev/vendizap/apis/api-vendizap/llms.txt) · [OpenAPI document](https://skmtc.dev/vendizap/apis/api-vendizap/revisions/2c0d0a254abb?raw)