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

> Lista los Grids de tu cuenta, con un resumen del esquema de columnas y el número de filas de cada Grid.

Devuelve los Grids visibles para tu clave de API, con metadatos suficientes para descubrir los IDs de Grid antes de exportar sus filas mediante [Obtener filas del Grid](https://docs.retailgrid.io/es/api-reference/grids/get-rows.md).

## 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 `50`, máximo `200`. |
| `cursor` | string | No | Cursor de paginación opaco devuelto por una respuesta anterior. |
| `name` | string | No | Coincidencia de subcadena, sin distinguir mayúsculas, contra el nombre del Grid. |
| `updated_after` | string (ISO-8601, UTC) | No | Devuelve solo los Grids actualizados en esta marca de tiempo o después. |

## Respuesta

```json theme={null}
{
  "data": [
    {
      "grid_id": "grd_01HX2K8E4Y",
      "name": "Dairy Q2 review",
      "row_count": 1284,
      "created_at": "2026-04-12T08:42:11Z",
      "updated_at": "2026-05-21T19:00:55Z",
      "created_by": {
        "user_id": "usr_01J7",
        "email": "pricing@yourcompany.com"
      },
      "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" }
      ]
    }
  ],
  "next_cursor": "eyJvZmZzZXQiOjUwfQ=="
}
```

El array `columns` es un resumen: nombres de columna, tipo semántico y origen de cada columna (`canonical`, `custom`, `formula`, `ai`). **No** incluye valores de fila. Para obtener los valores de fila, llama a [Obtener filas del Grid](https://docs.retailgrid.io/es/api-reference/grids/get-rows.md) con el `grid_id`.

## Ejemplo de solicitud

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

## Relacionado

* [Obtener filas del Grid](https://docs.retailgrid.io/es/api-reference/grids/get-rows.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.