---
title: "Listar/buscar productos (inventario)"
method: GET
path: "/productos"
tags: ["catalogos"]
---

# Listar/buscar productos (inventario)

`GET /productos`

## Request

- Base URL: `https://contadeo.com/api`
- URL: `https://contadeo.com/api/productos`
- Auth: HTTP bearer

Sin parámetros devuelve todo el catálogo activo (contrato legacy). Con `offset` pagina (límite por defecto 50, máx. 200).

## Query parameters

- `q` string
- `limit` integer
- `offset` integer
- `orden` 'nombre' | 'precio' | 'codigo' | 'stock'
- `dir` 'asc' | 'desc'
- `tarifa` string
- `categoria` string
- `estado` 'agotado' | 'bajo' | 'sin_control' | 'con_stock'
- `activo` 'true' | 'false' | 'todos'

## Response `200`

Productos

- Producto[]
  - `id` string, uuid
  - `codigoPrincipal` string
  - `codigoAuxiliar` string, nullable
  - `nombre` string
  - `precioUnitario` string
  - `impuestoCodigo` string
  - `tarifaCodigo` string
  - `stock` string, nullable: NULL = sin control de existencias; puede ser negativo
  - `stockMinimo` string, nullable
  - `costoUnitario` string, nullable: Lo que cuesta una unidad (módulo 20). Lo propone la toma física.
  - `unidadMedida` string, nullable
  - `categoria` string, nullable
  - `activo` boolean: false = archivado (fuera de listados por defecto)
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

---

[API](https://skmtc.dev/contadeo/apis/api-de-contadeo.md) · [All operations](https://skmtc.dev/contadeo/apis/api-de-contadeo/llms.txt) · [OpenAPI document](https://skmtc.dev/contadeo/apis/api-de-contadeo/revisions/461bbb9a74ce?raw)
