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

# Buscar productos

> Busca productos del catálogo con filtros opcionales

Endpoint para buscar productos. Todos los filtros son **opcionales**: sin filtros devuelve el catálogo completo paginado.

## Authorization

**Authorization** `string` *required*

Formato: `ApiKey TU_API_KEY`

## Body Parameters

Todos los campos son opcionales.

**sku** `string`

SKU exacto (1–64 caracteres).

**title** `string`

Filtra por título del producto.

**categoryUuids** `string[]`

Una o varias categorías (uuid).

**commercialBrands** `string[]`

Una o varias marcas comerciales (uuid).

**status** `string`

Estado del producto. Valores permitidos: `enabled`, `disabled`.

**digital** `boolean`

Filtro booleano.

**shippable** `boolean`

Filtro booleano.

**freeShipping** `boolean`

Filtro booleano.

**hasStock** `boolean`

Filtro booleano.

**hasDiscount** `boolean`

Filtro booleano.

**minPrice** `number`

Precio mínimo. No puede superar `maxPrice`.

**maxPrice** `number`

Precio máximo.

**minWeight** `number`

Peso mínimo.

**maxWeight** `number`

Peso máximo.

**installmentPlans** `number[]`

Planes de cuotas. Valores permitidos: `3`, `6`, `9`, `12`.

**limit** `integer`

Paginación. Máximo 200.

**offset** `integer`

Paginación. Máximo 100000.

## Response

**data** `array`

Lista de productos.

**producto**

**sku** `string`

**title** `string`

**categoryUuid** `string`

**brand** `string`

**price** `number`

**images** `string[]`

**condition** `string`

`NEW` (nuevo), `USED` (usado) o `REFURBISHED` (reacondicionado).

**digital** `boolean`

**shippable** `boolean`

**freeShipping** `boolean`

**stock** `integer`

**status** `string`

`enabled` o `disabled`.

**installmentPlans** `integer[]`

**commercialBrands** `string[]`

**attributes** `array`

**par de atributos**

**attributeId** `integer`

**valueId** `integer`

**pagination** `object`

**paginación**

**offset** `integer`

**limit** `integer`

**total** `integer`

**hasMore** `boolean`

## Errors

| Código | Descripción |
| - | - |
| `400` | Parámetros inválidos: `limit` mayor a 200, `offset` mayor a 100000, o `minPrice` mayor a `maxPrice`. |

```bash cURL theme={null}
curl --request POST \
  --url https://sandbox.external.cashea.app/v2/inventory/products/search \
  --header 'Authorization: ApiKey TU_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{ "status": "enabled", "hasStock": true, "limit": 3, "offset": 0 }'
```

```json Ejemplo 200 theme={null}
{
  "data": [
    {
      "sku": "TEST-SKU-00112",
      "title": "Producto de prueba API",
      "categoryUuid": "5f0ba846-e37f-4a67-8f03-95e998996c95",
      "brand": "SM Phones",
      "price": 299.99,
      "images": ["https://cdn.photo/800"],
      "condition": "NEW",
      "digital": false,
      "shippable": true,
      "freeShipping": true,
      "stock": 25,
      "status": "enabled",
      "installmentPlans": [3, 6],
      "commercialBrands": ["20353c61-45bd-4493-85a6-a264b35429d2"],
      "attributes": [ { "attributeId": 1, "valueId": 5 }, { "attributeId": 2, "valueId": 12 } ]
    }
  ],
  "pagination": { "offset": 0, "limit": 3, "total": 18157, "hasMore": true }
}
```


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