Listar Grids
curl --request GET \
--url https://clientapi.retailgrid.io/v1/gridsimport requests
url = "https://clientapi.retailgrid.io/v1/grids"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://clientapi.retailgrid.io/v1/grids', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://clientapi.retailgrid.io/v1/grids",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://clientapi.retailgrid.io/v1/grids"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://clientapi.retailgrid.io/v1/grids")
.asString();require 'uri'
require 'net/http'
url = URI("https://clientapi.retailgrid.io/v1/grids")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_bodyGrids
Listar Grids
Lista los Grids de tu cuenta, con un resumen del esquema de columnas y el número de filas de cada Grid.
GET
/
v1
/
grids
Listar Grids
curl --request GET \
--url https://clientapi.retailgrid.io/v1/gridsimport requests
url = "https://clientapi.retailgrid.io/v1/grids"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://clientapi.retailgrid.io/v1/grids', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://clientapi.retailgrid.io/v1/grids",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://clientapi.retailgrid.io/v1/grids"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://clientapi.retailgrid.io/v1/grids")
.asString();require 'uri'
require 'net/http'
url = URI("https://clientapi.retailgrid.io/v1/grids")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_bodyDevuelve 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.
El array
Autenticación
Token Bearer. Consulta Autenticación.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
{
"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=="
}
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 con el grid_id.
Ejemplo de solicitud
curl -s "https://clientapi.retailgrid.io/v1/grids?limit=25&updated_after=2026-05-01T00:00:00Z" \
-H "Authorization: Bearer rg_live_xxx"

