> ## 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 transacciones

> Lista las transacciones de venta para su ingesta en sistemas ERP y BI.

Devuelve las transacciones de venta visibles para tu clave de API, con los cambios más recientes al final. Combínalo con [Listar productos](https://docs.retailgrid.io/es/api-reference/products/list.md) para montar una vista de catálogo más ventas en tu almacén de datos sin pasar por el flujo de exportación CSV de la aplicación.

## 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 `1000`, máximo `10000`. Omítelo en una continuación para reutilizar el tamaño de la página original. |
| `cursor` | string | No | Cursor de paginación opaco devuelto como `next_cursor` en la respuesta anterior. |
| `updated_since` | string (ISO-8601) | No | Devuelve solo las transacciones modificadas en o después de esta marca de tiempo. Úsalo para sincronizaciones incrementales. |

> [!NOTE]
>
> Los filtros por rango de fechas y por producto o tienda (`from_date`, `to_date`, `product_id`, `store_id`) **no** están soportados en este endpoint. Los parámetros de consulta no soportados se ignoran en lugar de rechazarse, así que filtra en el lado del cliente o acota con `updated_since`.

## Respuesta

Los resultados llegan bajo `items`, ordenados por última actualización y luego por id, con un `next_cursor` opaco para la página siguiente (`null` en la última página).

```json theme={null}
{
  "items": [
    {
      "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
      "item_id": "SKU-12345",
      "store_id": "STORE-007",
      "sku": "SKU-12345",
      "region": "FI",
      "transaction_timestamp": "2026-05-21T16:42:09Z",
      "quantity": 2,
      "selling_price": 1.49,
      "regular_price": 1.79,
      "sales_value": 2.98,
      "gross_profit": 0.90,
      "stock_after_sale": 42,
      "promo_type": null,
      "zone_price": null
    }
  ],
  "next_cursor": "eyJvZmZzZXQiOjEwMDB9"
}
```

Consulta [Convenciones](https://docs.retailgrid.io/es/api-reference/conventions.md) para el formato de números y marcas de tiempo.

## Extracciones incrementales

Las filas de transacciones no incluyen `updated_at` en la respuesta, así que registra en tu lado la **hora de tu última sincronización exitosa** y pásala como `updated_since` en la siguiente ejecución. Recorre cada ejecución con `next_cursor` hasta que devuelva `null`; el servidor ordena por última actualización y luego por id, por lo que una ejecución iniciada a mitad del flujo se mantiene consistente. Esto captura correcciones tardías de transacciones existentes sin releer todo el historial.

## Ventanas grandes

Las páginas de hasta `limit=10000` se sirven desde snapshots y son la forma más rápida de extraer muchas filas. Para extracciones muy grandes, como una recarga completa del historial o un backfill de BI, es preferible una [exportación asíncrona](https://docs.retailgrid.io/es/api-reference/introduction.md) antes que una paginación profunda con cursor.

## Ejemplo de solicitud

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

## Relacionado

* [Última transacción por fecha de negocio](https://docs.retailgrid.io/es/api-reference/transactions/latest.md)

* [Upsert masivo de transacciones](https://docs.retailgrid.io/es/api-reference/transactions/bulk-upsert.md)

* [Listar productos](https://docs.retailgrid.io/es/api-reference/products/list.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.