KarritoKarrito Docs

Categorías

Endpoint para listar las categorías de tu tienda via la API REST de Karrito.

2 min de lecturaapi, rest, categorias, endpointsActualizado: 18 de marzo de 2026

Listar categorías

GET /api/v1/categories

Devuelve una lista paginada de las categorías de tu tienda, ordenadas por el campo position (la misma posición que configuras en el admin con drag and drop).

Parametros de query

Parametro Tipo Default Descripción
limit number 50 Resultados por página (max 100)
offset number 0 Resultados a saltar

Ejemplo con curl

curl "https://karrito.shop/api/v1/categories" \
  -H "Authorization: Bearer krt_live_a1b2c3d4e5f6g7h8i9j0"

Ejemplo con JavaScript

const response = await fetch("https://karrito.shop/api/v1/categories", {
  headers: {
    "Authorization": "Bearer krt_live_a1b2c3d4e5f6g7h8i9j0"
  }
});

const { data, total } = await response.json();
console.log(`${total} categorias`);

Respuesta

{
  "data": [
    {
      "id": "clx9z8y7w6v5u4t3s2r1q0",
      "name": "Camisas",
      "slug": "camisas",
      "position": 0,
      "isActive": true
    },
    {
      "id": "clx8y7w6v5u4t3s2r1q0p9",
      "name": "Pantalones",
      "slug": "pantalones",
      "position": 1,
      "isActive": true
    },
    {
      "id": "clx7w6v5u4t3s2r1q0p9o8",
      "name": "Accesorios",
      "slug": "accesorios",
      "position": 2,
      "isActive": true
    },
    {
      "id": "clx6v5u4t3s2r1q0p9o8n7",
      "name": "Temporada",
      "slug": "temporada",
      "position": 3,
      "isActive": false
    }
  ],
  "total": 4,
  "limit": 50,
  "offset": 0
}

Schema de categoría

Campo Tipo Descripción
id string Identificador único (CUID)
name string Nombre de la categoría
slug string URL-friendly del nombre
position number Orden de aparición (0 = primero)
isActive boolean Si la categoría esta visible en el catálogo

Notas

  • Las categorías inactivas (isActive: false) se incluyen en la respuesta de la API. Si solo quieres las activas, filtralas en tu código
  • La respuesta viene ordenada por position ascendente
  • Cada producto puede pertenecer a una sola categoría (o a ninguna)

Scope requerido

  • categories:read

Siguiente paso

Consulta las ordenes que llegan a tu tienda.