> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar sucursales

> Retorna la lista paginada de sucursales de tu tienda.

**app\_id** `string` *required*

ID de tu tienda en Jelou Shop.

**page** `integer` (default: 1)

Número de página a retornar.

**limit** `integer` (default: 15)

Cantidad de resultados por página (máx. 100).

**paginate** `boolean` (default: true)

Envía `false` para obtener todas las sucursales sin paginación.

> [!NOTE]
>
> El listado se ordena por `created_at` ascendente. Para ordenar por otros campos (`name`, `code`, `updated_at`) usa el endpoint [Buscar sucursales](https://docs.jelou.ai/api/shop/sucursales/buscar.md) con el parámetro `sort`.

## Campos de la respuesta

Cada sucursal en `data` contiene los siguientes campos:

| Campo | Tipo | Descripción |
| - | - | - |
| `id` | string | UUID de la sucursal |
| `name` | string | Nombre de la sucursal |
| `code` | string | Código único dentro de la tienda |
| `address` | string \| null | Dirección de la sucursal |
| `phone` | string \| null | Teléfono de la sucursal |
| `status` | boolean | Si la sucursal está activa |
| `properties` | object \| null | Propiedades personalizadas (incluye `language` si fue definido) |
| `products_count` | integer | Cantidad de productos **activos** asociados a la sucursal |
| `created_at` | string | Fecha de creación |
| `updated_at` | string | Fecha de última actualización |

```bash cURL theme={null}
curl "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/branches?page=1&limit=20" \
  -H "x-api-key: TU_CLAVE_API"
```

```json 200 Success theme={null}
{
  "data": [
    {
      "id": "9e3f2c1a-8b7d-4e6f-a5c4-d3b2a1e0f9c8",
      "name": "Sucursal Centro",
      "code": "SUC-CENTRO",
      "address": "Av. Principal 123, Quito",
      "phone": "+593991234567",
      "status": true,
      "properties": {
        "language": "es",
        "horario": "09:00 - 18:00"
      },
      "products_count": 42,
      "created_at": "2026-02-19T15:30:00.000000Z",
      "updated_at": "2026-02-19T15:30:00.000000Z"
    }
  ],
  "links": {
    "first": "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/branches?page=1",
    "last": "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/branches?page=1",
    "prev": null,
    "next": null
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "per_page": 15,
    "to": 1,
    "total": 1
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.