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

# Listar productos

> Lista los registros de producto enriquecidos, incluidas las columnas personalizadas añadidas en el momento de la importación.

Devuelve el catálogo de productos visible para tu clave de API. Cada registro incluye los campos canónicos del producto más un mapa `custom` con las columnas personalizadas que se añadieron al importar los productos.

Es la contraparte de lectura de [Upsert masivo de productos](https://docs.retailgrid.io/es/api-reference/products/bulk-upsert.md). Úsalo para la ingesta en ERP / BI cuando necesites el estado enriquecido actual del catálogo.

## Autenticación

Token Bearer. Consulta [Autenticación](https://docs.retailgrid.io/es/api-reference/authentication.md).

## Parámetros de consulta

| Nombre | Tipo | Obligatorio | Descripción |
| :- | :- | :- | :- |
| `limit` | integer | No | Tamaño de página, por defecto `100`, máximo `1000`. |
| `cursor` | string | No | Cursor de paginación opaco devuelto por una respuesta anterior. |
| `product_id` | string | No | Filtra por un único ID de producto canónico. |
| `sku` | string | No | Filtra por un único SKU. |
| `updated_after` | string (ISO-8601, UTC) | No | Devuelve solo los productos actualizados en esta marca de tiempo o después. |

## Respuesta

```json theme={null}
{
  "data": [
    {
      "product_id": "SKU-12345",
      "sku": "SKU-12345",
      "name": "Whole Milk 1L",
      "brand": "Arla",
      "category": "Dairy",
      "price": "1.49",
      "unit_cost": "0.92",
      "image_url": "https://cdn.example.com/sku-12345.jpg",
      "product_url": "https://www.example.com/products/sku-12345",
      "created_at": "2026-01-04T11:08:00Z",
      "updated_at": "2026-05-21T08:14:21Z",
      "custom": {
        "role": "KVI",
        "buyer": "E. Kirilov"
      }
    }
  ],
  "next_cursor": "eyJvZmZzZXQiOjEwMH0="
}
```

El mapa `custom` contiene todas las columnas personalizadas asociadas al producto durante la importación. Las claves son los nombres de columna que definiste.

Los valores numéricos se devuelven como cadenas. Consulta [Convenciones](https://docs.retailgrid.io/es/api-reference/conventions.md).

## Ejemplo de solicitud

```bash theme={null}
curl -s "https://clientapi.retailgrid.io/v1/products?updated_after=2026-05-01T00:00:00Z&limit=500" \
  -H "Authorization: Bearer rg_live_xxx"
```

## Relacionado

* [Upsert masivo de productos](https://docs.retailgrid.io/es/api-reference/products/bulk-upsert.md)
* [Convenciones](https://docs.retailgrid.io/es/api-reference/conventions.md)
* [Errores](https://docs.retailgrid.io/es/api-reference/errors.md)


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