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

# Obtener filas del Grid

> Exporta el contenido completo de las filas de un Grid: columnas canónicas, personalizadas y de fórmula o calculadas.

Devuelve el contenido de las filas de un Grid, incluidas las columnas canónicas, las columnas personalizadas añadidas por el usuario y las columnas de fórmula o calculadas. Es el equivalente programático de la acción [Export](https://docs.retailgrid.io/es/grids/export.md) de la aplicación.

Usa este endpoint cuando quieras extraer un espacio de trabajo construido por un usuario (con su conjunto de columnas y sus columnas calculadas) hacia un ERP, una herramienta de BI o un almacén de datos de forma programada.

## Autenticación

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

## Parámetros de ruta

| Nombre | Tipo | Obligatorio | Descripción |
| :- | :- | :- | :- |
| `grid_id` | string | Sí | El Grid a exportar. Descubre los IDs mediante [Listar Grids](https://docs.retailgrid.io/es/api-reference/grids/list.md). |

## Parámetros de consulta

| Nombre | Tipo | Obligatorio | Descripción |
| :- | :- | :- | :- |
| `limit` | integer | No | Tamaño de página, por defecto `1000`, máximo `10000`. |
| `cursor` | string | No | Cursor de paginación opaco devuelto por una respuesta anterior. |
| `columns` | string | No | Lista de nombres de columna separados por comas que se incluirán. Por defecto, todas las columnas del Grid. |
| `updated_after` | string (ISO-8601, UTC) | No | Devuelve solo las filas actualizadas en esta marca de tiempo o después. |

## Respuesta

```json theme={null}
{
  "grid_id": "grd_01HX2K8E4Y",
  "columns": [
    { "name": "product_id", "type": "string", "source": "canonical" },
    { "name": "price", "type": "number", "source": "canonical" },
    { "name": "margin", "type": "number", "source": "formula" },
    { "name": "role", "type": "single_select", "source": "custom" }
  ],
  "data": [
    {
      "product_id": "SKU-12345",
      "price": "4.99",
      "margin": "0.31",
      "role": "KVI"
    }
  ],
  "next_cursor": "eyJvZmZzZXQiOjEwMDB9"
}
```

Los valores numéricos se devuelven como strings; consulta [Convenciones](https://docs.retailgrid.io/es/api-reference/conventions.md) para conocer el motivo.

## Grids grandes

Para Grids de más de \~50k filas, pagina con `limit=5000` y sigue `next_cursor` hasta que devuelva `null`. Extraer el Grid completo en una sola llamada está permitido hasta el tope de `limit`, pero es más lento que las extracciones por bloques y tiene más probabilidades de requerir un reintento ante fallos transitorios.

Si solo necesitas un subconjunto de columnas, pasa `columns=`: la respuesta es más pequeña y la exportación, más rápida.

## Ejemplo de solicitud

```bash theme={null}
curl -s "https://clientapi.retailgrid.io/v1/grids/grd_01HX2K8E4Y/rows?limit=5000&columns=product_id,price,margin" \
  -H "Authorization: Bearer rg_live_xxx"
```

## Relacionado

* [Listar Grids](https://docs.retailgrid.io/es/api-reference/grids/list.md)
* [Exportar desde la aplicación](https://docs.retailgrid.io/es/grids/export.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.